ASPxClientListBox.CustomHighlighting Event

Enables you to highlight the filtered items.

Declaration

CustomHighlighting: ASPxClientEvent<ASPxClientListEditCustomHighlightingEventHandler<ASPxClientListBox>>

Event Data

The CustomHighlighting event's data class is ASPxClientListEditCustomHighlightingEventArgs. The following properties provide information specific to this event:

Property	Description
filter	Gets a string that is a filter condition for the editor’s items typed by a user.
highlighting	Specifies rules according to which the editor highlights the filtered items.

Remarks

The CustomHighlighting event is used to highlight the editor items that match filter criteria. Note that the CustomHighlighting event is raised once for all items, while the ASPxClientListBox.ItemFiltering event is raised for each item.

In callback mode, the ASPxClientListEditCustomHighlightingEventArgs.highlighting property’s default value is obtained from the ListEditCustomFilteringEventArgs.CustomHighlighting property if the latter is specified in the ASPxListBox.CustomFiltering event. If the callback mode is disabled or the ListEditCustomFilteringEventArgs.CustomHighlighting property is not specified, the ASPxClientListEditCustomHighlightingEventArgs.highlighting property default value is null. Refer to the ASPxClientListEditCustomHighlightingEventArgs.highlighting property description for more information.

Note

The CustomHighlighting event can be raised either immediately after the items are filtered (the ASPxListBox.EnableCallbackMode property is set to false) or after the first callback is initiated (the ASPxListBox.EnableCallbackMode property is set to true).