Tab
A newer version of this page is available. Switch to the current version.

ASPxTitleIndex Class

Represents an ASPxTitleIndex server control.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v18.2.dll

Declaration

public class ASPxTitleIndex :
    ASPxDataWebControl,
    IRequiresLoadPostDataControl,
    IControlDesigner
Public Class ASPxTitleIndex
    Inherits ASPxDataWebControl
    Implements IRequiresLoadPostDataControl,
               IControlDesigner

Related API Members

The following members accept/return ASPxTitleIndex objects:

Remarks

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).

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.

veASPxTitleIndex

The ASPxTitleIndex control allows its displayed information to be broken into several columns. Columns are represented by the TitleIndexColumn class instances which are contained within the ASPxTitleIndex.Columns collection of the control. The number of columns can be easily defined via the ASPxTitleIndex.ColumnCount property.

The ASPxTitleIndex control's data items can be displayed either in groups (items within a group are represented into one column, while groups can be arranged into multiple columns within the control) or in categories (categories are displayed one under another, and can display multiple item columns). This behavior is controlled by the ASPxTitleIndex.Categorized property.

The ASPxTitleIndex control offers you complete style customization of its different elements such as data items, index panel, columns, links, etc (for instance, see the ASPxTitleIndex.ItemStyle, ASPxTitleIndex.IndexPanelStyle, ASPxTitleIndex.ColumnStyle, ASPxTitleIndex.LinkStyle properties).

Additionally, you can use the template technology to get unlimited control over the contents of data items, group headers and column separators. You can specify these templates via the ASPxTitleIndex.ItemTemplate, ASPxTitleIndex.GroupHeaderTemplate and ASPxTitleIndex.ColumnSeparatorTemplate properties.

Note that round trips to the server initiated when the IndexPanel.Behavior property is set to the IndexPanelBehavior.Filtering value can be performed either using standard postbacks (the whole page is refreshed) or the newly implemented AJAX-based callback technology. In this case, the ASPxTitleIndex.EnableCallBacks property of the ASPxTitleIndex control can be used to specify which technology to use when posting back to the server.

NOTE

The ASPxTitleIndex control provides you with a comprehensive client-side functionality implemented using JavaScript code (see DevExpress.Web.Scripts to learn more):

The client-side API is always available for this control.

See Also