Classe: TDataList  - X-Ref

TDataList class

TDataList represents a data bound and updatable list control.

The {@link setHeaderTemplate HeaderTemplate} property specifies the content
template that will be displayed at the beginning, while
{@link setFooterTemplate FooterTemplate} at the end.
If present, these two templates will only be rendered when the data list is
given non-empty data. In this case, for each data item the content defined
by {@link setItemTemplate ItemTemplate} will be generated and displayed once.
If {@link setAlternatingItemTemplate AlternatingItemTemplate} is not empty,
then the corresponding content will be displayed alternatively with that
in {@link setItemTemplate ItemTemplate}. The content in
{@link setSeparatorTemplate SeparatorTemplate}, if not empty, will be
displayed between items. Besides the above templates, there are two additional
templates, {@link setEditItemTemplate EditItemTemplate} and
{@link setSelectedItemTemplate SelectedItemTemplate}, which are used to display
items that are in edit and selected mode, respectively.

All these templates are associated with styles that may be applied to
the corresponding generated items. For example,
{@link getAlternatingItemStyle AlternatingItemStyle} will be applied to
every alternating item in the data list.

Item styles are applied in a hierarchical way. Style in higher hierarchy
will inherit from styles in lower hierarchy.
Starting from the lowest hierarchy, the item styles include
item's own style, {@link getItemStyle ItemStyle}, {@link getAlternatingItemStyle AlternatingItemStyle},
{@link getSelectedItemStyle SelectedItemStyle}, and {@link getEditItemStyle EditItemStyle}.
Therefore, if background color is set as red in {@link getItemStyle ItemStyle},
{@link getEditItemStyle EditItemStyle} will also have red background color
unless it is set to a different value explicitly.

To change the status of a particular item, set {@link setSelectedItemIndex SelectedItemIndex}
or {@link setEditItemIndex EditItemIndex}. The former will change the indicated
item to selected mode, which will cause the item to use {@link setSelectedItemTemplate SelectedItemTemplate}
for presentation. The latter will change the indicated item to edit mode.
Note, if an item is in edit mode, then selecting this item will have no effect.

The layout of the data items in the list is specified via
{@link setRepeatLayout RepeatLayout}, which can be either 'Table' (default) or 'Flow'.
A table layout uses HTML table cells to organize the data items while
a flow layout uses line breaks to organize the data items.
When the layout is using 'Table', {@link setCellPadding CellPadding} and
{@link setCellSpacing CellSpacing} can be used to adjust the cellpadding and
cellpadding of the table, and {@link setCaption Caption} and {@link setCaptionAlign CaptionAlign}
can be used to add a table caption with the specified alignment.

The number of columns used to display the data items is specified via
{@link setRepeatColumns RepeatColumns} property, while the {@link setRepeatDirection RepeatDirection}
governs the order of the items being rendered.

You can retrive the repeated contents by the {@link getItems Items} property.
The header and footer items can be accessed by {@link getHeader Header}
and {@link getFooter Footer} properties, respectively.

When TDataList creates an item, it will raise an {@link onItemCreated OnItemCreated}
so that you may customize the newly created item.
When databinding is performed by TDataList, for each item once it has finished
databinding, an {@link onItemDataBound OnItemDataBound} event will be raised.

When an item is selected by an end-user, a {@link onSelectedIndexChanged OnSelectedIndexChanged}
event will be raised. Note, the selected index may not be actually changed.
The event mainly informs the server side that the end-user has made a selection.

Each datalist item has a {@link TDataListItem::getItemType type}
which tells the position and state of the item in the datalist. An item in the header
of the repeater is of type Header. A body item may be of either
Item, AlternatingItem, SelectedItem or EditItem, depending whether the item
index is odd or even, whether it is being selected or edited.

TDataList raises an {@link onItemCommand OnItemCommand} whenever a button control
within some TDataList item raises a <b>OnCommand</b> event. If the command name
is one of the followings: 'edit', 'update', 'select', 'delete', 'cancel' (case-insensitive),
another event will also be raised. For example, if the command name is 'edit',
then the new event is {@link onEditCommand OnEditCommand}.

Note, the data bound to the datalist are reset to null after databinding.
There are several ways to access the data associated with a datalist item:
- Access the data in {@link onItemDataBound OnItemDataBound} event
- Use {@link getDataKeys DataKeys} to obtain the data key associated with
the specified datalist item and use the key to fetch the corresponding data
from some persistent storage such as DB.
- Save the data in viewstate and get it back during postbacks.

Classe: TDataListItemEventParameter  - X-Ref

TDataListItemEventParameter class

TDataListItemEventParameter encapsulates the parameter data for
{@link TDataList::onItemCreated ItemCreated} event of {@link TDataList} controls.
The {@link getItem Item} property indicates the DataList item related with the event.

Classe: TDataListCommandEventParameter  - X-Ref

TDataListCommandEventParameter class

TDataListCommandEventParameter encapsulates the parameter data for
{@link TDataList::onItemCommand ItemCommand} event of {@link TDataList} controls.

The {@link getItem Item} property indicates the DataList item related with the event.
The {@link getCommandSource CommandSource} refers to the control that originally
raises the Command event.

Classe: TDataListItem  - X-Ref

TDataListItem class

A TDataListItem control represents an item in the {@link TDataList} control,
such as heading section, footer section, or a data item.
The index and data value of the item can be accessed via {@link getItemIndex ItemIndex}>
and {@link getDataItem DataItem} properties, respectively. The type of the item
is given by {@link getItemType ItemType} property.

Classe: TDataListItemCollection  - X-Ref

TDataListItemCollection class.

TDataListItemCollection represents a collection of data list items.