## 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:

     $datagridItem->HyperLinkColumnID->HyperLink
     $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 1398 2006-09-08 19:31:03Z 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 getDataNavigateUrlField ()
string getDataNavigateUrlFormatString ()
string getDataTextField ()
string getDataTextFormatString ()
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 198)

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::getDataFieldValue()
> TDataGridColumn::getFooterStyle()
> TDataGridColumn::getFooterText()
> TDataGridColumn::getHeaderImageUrl()
> TDataGridColumn::getHeaderStyle()
> TDataGridColumn::getHeaderText()
> TDataGridColumn::getID()
> TDataGridColumn::getItemStyle()
> TDataGridColumn::getOwner()
> TDataGridColumn::getSortExpression()
> TDataGridColumn::getViewState()
> TDataGridColumn::getVisible()
> TDataGridColumn::initialize()
> TDataGridColumn::initializeCell()
> TDataGridColumn::loadState()
> TDataGridColumn::saveState()
> TDataGridColumn::setFooterText()
> TDataGridColumn::setHeaderImageUrl()
> 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 Sun, 14 Jan 2007 21:42:46 -0500 by phpDocumentor 1.3.0RC4