TcxMRUEdit Object

Applies to TestComplete 14.60, last modified on April 22, 2021

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.

TcxMRUEdit Properties

TcxMRUEdit Methods

TcxMRUEdit Events

See Also

User Forms
TcxButtonEdit Object
TcxMRUEditProperties Object

Highlight search results