The TcxMRUEdit
component is an edit box that automatically stores all entered values. When typing text the next time, the user can select the recently used strings from the drop-down window. This window is displayed by pressing the down-arrow button of the component (if the component’s Properties.ImmediateDropDown
property is True, the component also displays the drop-down list when a user types characters within the edit field).
If the Properties.ShowEllipsis
property is True, the component also contains the ellipsis button. Pressing this button is processed by a special event handler, that when used you can perform various actions (for instance, display the Open File or Save File dialog).
The TcxMRUEdit
component is similar to the TcxButtonEdit
component that contains several buttons. However, the difference is that TcxMRUEdit
encapsulates the default behavior for the down-arrow button.
The current value displayed in the edit box is specified by the Text
property. The Properties.LookupItems
property holds a list of values displayed in the drop-down window. This list holds values added at design time and values entered during the test run. The maximum number of stored items is specified by the Properties.MaxItemCount
property. When a user specifies a new value, it is added to the beginning of the list shifting all other items down.
The TcxMRUEdit
component stores the values during the whole test run. For instance, if your test script displays a user form with the TcxMRUEdit
component on it and then hides the form and then displays it again, the component will “remember” recenly entered values. Note that the component does not save values between different test runs. That is, all entered values will be lost once the test run is over.
The TcxMRUEdit
component raises a number of events that you can process in your scripts. For example, you can create an event handler for the OnButtonClick
event to process clicks on buttons embedded into the component.