Class THyperLinkColumn

Description

THyperLinkColumn class

THyperLinkColumn contains a hyperlink for each item in the column. You can set the text and the url of the hyperlink by Text and NavigateUrl properties, respectively. You can also bind the text and url to specific data field in datasource by setting DataTextField and DataNavigateUrlField. Both can be formatted before rendering according to the DataTextFormatString and and DataNavigateUrlFormatString properties, respectively. If both Text and DataTextField are present, the latter takes precedence. The same rule applies to NavigateUrl and DataNavigateUrlField properties.

The hyperlinks in the column can be accessed by one of the following two methods:

  1. $datagridItem->HyperLinkColumnID->HyperLink
  2. $datagridItem->HyperLinkColumnID->Controls[0]
The second method is possible because the hyperlink control created within the datagrid cell is the first child.

  • since: 3.0
  • version: $Id: THyperLinkColumn.php 1673 2007-02-05 21:55:51Z xue $
  • author: Qiang Xue <qiang.xue@gmail.com>

Located in /Web/UI/WebControls/THyperLinkColumn.php (line 52)

TComponent
   |
   --TApplicationComponent
      |
      --TDataGridColumn
         |
         --THyperLinkColumn
Method Summary
void dataBindColumn (mixed $sender, mixed $param)
string getDataTextField ()
string getNavigateUrl ()
string getTarget ()
string getText ()
void initializeCell (TTableCell $cell, integer $columnIndex, string $itemType)
void setDataNavigateUrlField (string $value)
void setDataNavigateUrlFormatString (string $value)
void setDataTextField (string $value)
void setDataTextFormatString (string $value)
void setNavigateUrl (string $value)
void setTarget (string $value)
void setText (string $value)
Methods
dataBindColumn (line 199)

Databinds a cell in the column.

This method is invoked when datagrid performs databinding. It populates the content of the cell with the relevant data from data source.

  • access: public
void dataBindColumn (mixed $sender, mixed $param)
getDataNavigateUrlField (line 123)
  • return: the field name from the data source to bind to the navigate url of hyperlink
  • access: public
string getDataNavigateUrlField ()
getDataNavigateUrlFormatString (line 139)
  • return: the formatting string used to control how the navigate url of hyperlink will be displayed.
  • access: public
string getDataNavigateUrlFormatString ()
getDataTextField (line 74)
  • return: the field name from the data source to bind to the hyperlink caption
  • access: public
string getDataTextField ()
getDataTextFormatString (line 90)
  • return: the formatting string used to control how the hyperlink caption will be displayed.
  • access: public
string getDataTextFormatString ()
getNavigateUrl (line 106)
  • return: the URL to link to when the hyperlink is clicked.
  • access: public
string getNavigateUrl ()
getTarget (line 155)
  • return: the target window or frame to display the Web page content linked to when the hyperlink is clicked.
  • access: public
string getTarget ()
getText (line 57)
  • return: the text caption of the hyperlink
  • access: public
string getText ()
initializeCell (line 177)

Initializes the specified cell to its initial values.

This method overrides the parent implementation. It creates a hyperlink within the cell.

  • access: public
void initializeCell (TTableCell $cell, integer $columnIndex, string $itemType)
  • TTableCell $cell: the cell to be initialized.
  • integer $columnIndex: the index to the Columns property that the cell resides in.
  • string $itemType: the type of cell (Header,Footer,Item,AlternatingItem,EditItem,SelectedItem)

Redefinition of:
TDataGridColumn::initializeCell()
Initializes the specified cell to its initial values.
setDataNavigateUrlField (line 131)
  • access: public
void setDataNavigateUrlField (string $value)
  • string $value: the field name from the data source to bind to the navigate url of hyperlink
setDataNavigateUrlFormatString (line 147)
  • access: public
void setDataNavigateUrlFormatString (string $value)
  • string $value: the formatting string used to control how the navigate url of hyperlink will be displayed.
setDataTextField (line 82)
  • access: public
void setDataTextField (string $value)
  • string $value: the field name from the data source to bind to the hyperlink caption
setDataTextFormatString (line 98)
  • access: public
void setDataTextFormatString (string $value)
  • string $value: the formatting string used to control how the hyperlink caption will be displayed.
setNavigateUrl (line 115)

Sets the URL to link to when the hyperlink is clicked.

  • access: public
void setNavigateUrl (string $value)
  • string $value: the URL
setTarget (line 164)

Sets the target window or frame to display the Web page content linked to when the hyperlink is clicked.

  • access: public
void setTarget (string $value)
  • string $value: the target window, valid values include '_blank', '_parent', '_self', '_top' and empty string.
setText (line 66)

Sets the text caption of the hyperlink.

  • access: public
void setText (string $value)
  • string $value: the text caption to be set

Inherited Methods

Inherited From TDataGridColumn

TDataGridColumn::formatDataValue()
TDataGridColumn::getAllowSorting()
TDataGridColumn::getDataFieldValue()
TDataGridColumn::getEnableCellGrouping()
TDataGridColumn::getFooterRenderer()
TDataGridColumn::getFooterStyle()
TDataGridColumn::getFooterText()
TDataGridColumn::getHeaderImageUrl()
TDataGridColumn::getHeaderRenderer()
TDataGridColumn::getHeaderStyle()
TDataGridColumn::getHeaderText()
TDataGridColumn::getID()
TDataGridColumn::getItemStyle()
TDataGridColumn::getOwner()
TDataGridColumn::getSortExpression()
TDataGridColumn::getViewState()
TDataGridColumn::getVisible()
TDataGridColumn::initialize()
TDataGridColumn::initializeCell()
TDataGridColumn::initializeFooterCell()
TDataGridColumn::initializeHeaderCell()
TDataGridColumn::loadState()
TDataGridColumn::saveState()
TDataGridColumn::setEnableCellGrouping()
TDataGridColumn::setFooterRenderer()
TDataGridColumn::setFooterText()
TDataGridColumn::setHeaderImageUrl()
TDataGridColumn::setHeaderRenderer()
TDataGridColumn::setHeaderText()
TDataGridColumn::setID()
TDataGridColumn::setOwner()
TDataGridColumn::setSortExpression()
TDataGridColumn::setViewState()
TDataGridColumn::setVisible()

Inherited From TApplicationComponent

TApplicationComponent::getApplication()
TApplicationComponent::getRequest()
TApplicationComponent::getResponse()
TApplicationComponent::getService()
TApplicationComponent::getSession()
TApplicationComponent::getUser()
TApplicationComponent::publishAsset()
TApplicationComponent::publishFilePath()

Inherited From TComponent

TComponent::addParsedObject()
TComponent::attachEventHandler()
TComponent::canGetProperty()
TComponent::canSetProperty()
TComponent::createdOnTemplate()
TComponent::detachEventHandler()
TComponent::evaluateExpression()
TComponent::evaluateStatements()
TComponent::getEventHandlers()
TComponent::getSubProperty()
TComponent::hasEvent()
TComponent::hasEventHandler()
TComponent::hasProperty()
TComponent::raiseEvent()
TComponent::setSubProperty()
TComponent::__get()
TComponent::__set()

Documentation generated on Mon, 21 Apr 2008 11:35:12 -0400 by phpDocumentor 1.3.0RC4