Class TButtonColumn

Description

TButtonColumn class

TButtonColumn contains a user-defined command button, such as Add or Remove, that corresponds with each row in the column.

The caption of the buttons in the column is determined by Text and DataTextField properties. If both are present, the latter takes precedence. The DataTextField property refers to the name of the field in datasource whose value will be used as the button caption. If DataTextFormatString is not empty, the value will be formatted before rendering.

The buttons in the column can be set to display as hyperlinks or push buttons by setting the ButtonType property. The CommandName will assign its value to all button's CommandName property. The datagrid will capture the command event where you can write event handlers based on different command names. The buttons' CausesValidation and ValidationGroup property values are determined by the column's corresponding properties.

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

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

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

Located in /Web/UI/WebControls/TButtonColumn.php (line 55)

TComponent
   |
   --TApplicationComponent
      |
      --TDataGridColumn
         |
         --TButtonColumn
Method Summary
void dataBindColumn (mixed $sender, mixed $param)
boolean getCausesValidation ()
string getCommandName ()
string getDataTextField ()
string getImageUrl ()
string getText ()
string getValidationGroup ()
void initializeCell (TTableCell $cell, integer $columnIndex, string $itemType)
void setCausesValidation (boolean $value)
void setCommandName (string $value)
void setDataImageUrlField (string $value)
void setDataImageUrlFormatString (string $value)
void setDataTextField (string $value)
void setDataTextFormatString (string $value)
void setImageUrl (string $value)
void setText (string $value)
void setValidationGroup (string $value)
Methods
dataBindColumn (line 259)

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)
getButtonType (line 157)
  • return: the type of command button. Defaults to TButtonColumnType::LinkButton.
  • access: public
TButtonColumnType getButtonType ()
getCausesValidation (line 190)
  • return: whether postback event trigger by this button will cause input validation, default is true
  • access: public
boolean getCausesValidation ()
getCommandName (line 173)
  • return: the command name associated with the OnCommand event.
  • access: public
string getCommandName ()
getDataImageUrlField (line 125)
  • return: the field name from the data source to bind to the button image url
  • access: public
string getDataImageUrlField ()
getDataImageUrlFormatString (line 141)
  • return: the formatting string used to control how the button image url will be displayed.
  • access: public
string getDataImageUrlFormatString ()
getDataTextField (line 77)
  • return: the field name from the data source to bind to the button caption
  • access: public
string getDataTextField ()
getDataTextFormatString (line 93)
  • return: the formatting string used to control how the button caption will be displayed.
  • access: public
string getDataTextFormatString ()
getImageUrl (line 109)
  • return: the URL of the image file for image buttons
  • access: public
string getImageUrl ()
getText (line 60)
  • return: the text caption of the button
  • access: public
string getText ()
getValidationGroup (line 206)
  • return: the group of validators which the button causes validation upon postback
  • access: public
string getValidationGroup ()
initializeCell (line 227)

Initializes the specified cell to its initial values.

This method overrides the parent implementation. It creates a command button 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.
setButtonType (line 165)
  • access: public
void setButtonType (TButtonColumnType $value)
setCausesValidation (line 198)
  • access: public
void setCausesValidation (boolean $value)
  • boolean $value: whether postback event trigger by this button will cause input validation
setCommandName (line 182)

Sets the command name associated with the Command event.

  • access: public
void setCommandName (string $value)
  • string $value: the text caption to be set
setDataImageUrlField (line 133)
  • access: public
void setDataImageUrlField (string $value)
  • string $value: the field name from the data source to bind to the button image url
setDataImageUrlFormatString (line 149)
  • access: public
void setDataImageUrlFormatString (string $value)
  • string $value: the formatting string used to control how the button image url will be displayed.
setDataTextField (line 85)
  • access: public
void setDataTextField (string $value)
  • string $value: the field name from the data source to bind to the button caption
setDataTextFormatString (line 101)
  • access: public
void setDataTextFormatString (string $value)
  • string $value: the formatting string used to control how the button caption will be displayed.
setImageUrl (line 117)
  • access: public
void setImageUrl (string $value)
  • string $value: the URL of the image file for image buttons
setText (line 69)

Sets the text caption of the button.

  • access: public
void setText (string $value)
  • string $value: the text caption to be set
setValidationGroup (line 214)
  • access: public
void setValidationGroup (string $value)
  • string $value: the group of validators which the button causes validation upon postback

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:31:58 -0400 by phpDocumentor 1.3.0RC4