Represents an ASPxTitleIndex server control.
public class ASPxTitleIndex : ASPxDataWebControl, IRequiresLoadPostDataControl, IControlDesigner
Public Class ASPxTitleIndex Inherits ASPxDataWebControl Implements IRequiresLoadPostDataControl, IControlDesigner
Related API Members
The following members accept/return ASPxTitleIndex objects:
The ASPxTitleIndex class represents a server control that displays its data as a sorted and grouped list of data items (titles or links).
The data that is displayed within the ASPxTitleIndex control can be either contained within the control itself (unbound mode) or obtained from a non-hierarchical data source (bound mode).
- In unbound mode, the control maintains its data items in its ASPxTitleIndex.Items collection. In this case, each data item is represented by an instance of the TitleIndexItem class. A data item's characteristics (such as a caption text, navigation location, tooltip text and the value of the group to which the item belongs) are defined by specific properties of this class (the TitleIndexItem.Text, TitleIndexItem.NavigateUrl, TitleIndexItem.Description and TitleIndexItem.GroupValue).
In bound mode, the control uses its ASPxDataWebControl.DataSourceID property to bind to a data source. In this case, characteristics of data items are taken from the data source's data fields mapped via specific data binding properties (the ASPxTitleIndex.TextField, ASPxTitleIndex.NavigateUrlField, ASPxTitleIndex.DescriptionField and ASPxTitleIndex.GroupingField).
If individual data fields have the same names as the TitleIndexItem class' properties defining a data item's major characteristics (the Text and NavigateUrl), the ASPxTitleIndex control takes data from these fields automatically without the necessity to map them via the corresponding data binding properties.
During data binding, a specific ASPxTitleIndex.ItemDataBound event is generated which will allow information from any desired data field to be obtained and processed as required. If needed, you can use this event to group data by any bound field's values.
The ASPxTitleIndex control allows its data items to be indexed and easily navigated via a specific index panel. The index panel's settings can be customized via the ASPxTitleIndex.IndexPanel property. So, the index panel's visibility and position are specified via the IndexPanel.Visible and IndexPanel.Position properties. The IndexPanel.Behavior property controls how the ASPxTitleIndex control responds to clicks on items displayed within the index panel. By default, the index panel's items are represented by the first characters of the automatically parsed data item titles (caption texts). In order to add the custom index characters to the index panel, or organize the index panel items in the desired manner (for example insert line feeds at arbitrary positions), the IndexPanel.Characters property can be used. If grouping by specific values is applied within the ASPxTitleIndex control (via the ASPxTitleIndex.GroupingField or TitleIndexItem.GroupValue property), these grouping values are displayed as the index panel's items, and used to group the control's data.
The ASPxTitleIndex control can display a specific filter box element, which allows data items to be easily located by typing the initial part of the caption into the filter box's editor. Different settings of the filter box can be customized by using the ASPxTitleIndex.FilterBox property.