TcxCustomMRUEdit Class

Serves as the base class for classes that implement text editors displaying the list of most recently used items (MRU) within a drop-down window.

Declaration

TcxCustomMRUEdit = class(
    TcxCustomComboBox
)

Remarks

This class extends the TcxCustomComboBox functionality introducing the ability to display a list of items within a drop-down window. TcxCustomMRUEdit maintains recently entered text items at the top of the drop-down list. When a new item is added, it is placed at the top of the list. When an existing list item is accessed, it is also moved to the first position. Use the AddItem method to add a new item or shift an existing item to the top of the list. At runtime a new item is added when the editor loses focus. An MRU editor supports the auto-completion feature, which enables a user to select an item from the list by typing its initial characters.

The Properties object contains various settings specific to MRU editors. The LookupItems member allows you to access the list of items. The number of items an MRU editor maintains can be limited by the MaxItemCount property. By default, an MRU editor displays the ellipsis (…) button, which does not provide any functionality, except that it generates the OnButtonClick event. To hide the ellipsis button set the ShowEllipsis property to False.

Use the Style, StyleDisabled, StyleFocused, and StyleHot properties to adjust an editor’s appearance. Working with styles is discussed in the TcxCustomEditStyle class topic.

Do not create instances of TcxCustomMRUEdit. Use its descendants such as TcxMRUEdit or TcxDBMRUEdit instead.