Class TDropDownListColumn
TDropDownListColumn class
TDropDownListColumn represents a column that is bound to a field in a data source. The cells in the column will be displayed using the data indexed by setDataTextField DataTextField. You can customize the display by setting setDataTextFormatString DataTextFormatString.
If setReadOnly ReadOnly is false, TDropDownListColumn will display cells in edit mode with dropdown lists. Otherwise, a static text is displayed. The currently selected dropndown list item is specified by the data indexed with setDataValueField DataValueField.
There are two approaches to specify the list items available for selection. The first approach uses template syntax as follows,
<com:TDropDownListColumn ....> <com:TListItem Value="1" Text="first item" /> <com:TListItem Value="2" Text="second item" /> <com:TListItem Value="3" Text="third item" /> </com:TDropDownListColumn>
The second approach specifies a data source to be bound to the dropdown lists by setting setListDataSource ListDataSource. Like generic list controls, you may also want to specify which data fields are used for item values and texts by setting setListValueField ListValueField and setListTextField ListTextField, respectively. Furthermore, the item texts may be formatted by using setListTextFormatString ListTextFormatString. Note, if you specify setListDataSource ListDataSource, do it before calling the datagrid's dataBind().
The dropdown list control in the TDropDownListColumn can be accessed by one of the following two methods:
$datagridItem->DropDownListColumnID->DropDownList $datagridItem->DropDownListColumnID->Controls[0]
The second method is possible because the dropdown list control created within the datagrid cell is the first child.
- TComponent
-
TApplicationComponent
-
TDataGridColumn
-
TDropDownListColumn
Direct known subclasses
TActiveDropDownListColumnCopyright: Copyright © 2005-2014 PradoSoft
License: http://www.pradosoft.com/license/
Author: Qiang Xue <qiang.xue@gmail.com>
Since: 3.0.4
Located at Web/UI/WebControls/TDropDownListColumn.php
public
|
#
__construct( )
The common __construct If desired by the new object, this will auto install and listen to global event functions as defined by the object via 'fx' methods. This also attaches any predefined behaviors. This function installs all class behaviors in a class hierarchy from the deepest subclass through each parent to the top most class, TComponent. |
public
|
#
loadState( mixed $state )
Loads items from viewstate. This method overrides the parent implementation by loading list items |
public
mixed
|
#
saveState( )
Saves items into viewstate. This method overrides the parent implementation by saving list items |
public
|
|
public
string
|
|
public
|
#
setDataTextField( string $value )
Sets the field of the data source that provides the text content of the column. If this is not set, the data specified via getDataValueField DataValueField will be displayed in the column. |
public
string
|
|
public
|
|
public
string
|
|
public
|
#
setDataValueField( string $value )
Sets the field of the data source that provides the key selecting an item in dropdown list. If this is not present, the data specified via getDataTextField DataTextField (without applying the formatting string) will be used for selection, instead. |
public
boolean
|
|
public
|
|
public
Traversable
|
|
public
|
|
public
string
|
|
public
|
|
public
string
|
|
public
|
|
public
string
|
|
public
|
|
public
|
#
initializeCell(
Initializes the specified cell to its initial values. This method overrides the parent implementation. It creates a textbox for item in edit mode and the column is not read-only. Otherwise it displays a static text. The caption of the button and the static text are retrieved from the datasource. |
public
|
#
dataBindColumn( mixed $sender, mixed $param )
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. |
getApplication(),
getRequest(),
getResponse(),
getService(),
getSession(),
getUser(),
publishAsset(),
publishFilePath()
|
GLOBAL_RAISE_EVENT_LISTENER
|