MRUEdit Class

The text editor that allows you to type a value or choose one of most recently used (MRU) values from a dropdown list.

Assembly: DevExpress.XtraEditors.v18.1.dll

Declaration

C#
VB.NET

[ToolboxTabName("DX.18.1: Common Controls")]
[ToolboxBitmap(typeof(ToolboxIconsRootNS), "MRUEdit")]
public class MRUEdit :
    ComboBoxEdit

<ToolboxBitmap(GetType(ToolboxIconsRootNS), "MRUEdit")>
<ToolboxTabName("DX.18.1: Common Controls")>
Public Class MRUEdit
    Inherits ComboBoxEdit

Remarks

The MRUEdit is a popup text editor that automatically saves typed strings to its dropdown list. Newly entered values are automatically saved in the RepositoryItemMRUEdit.Items collection after successful validation (the data is validated when moving focus to another control or when pressing the ENTER key, provided that the RepositoryItemMRUEdit.ValidateOnEnterKey property is set to true).

End-users can access recent items by opening the dropdown window.

MRUEdit class

When a new string is added, it becomes the first item in the list.

The number of items an MRU editor maintains can be limited by the RepositoryItemMRUEdit.MaxItemCount property.

The MRUEdit control supports the automatic filtering feature. By default, typing within the edit box automatically invokes the dropdown. All items that are currently displayed in the dropdown match the currently typed text. Items that do not match the edited text are hidden. Note that the dropdown is automatically opened when text is being entered if the RepositoryItemMRUEdit.ImmediatePopup property is set to true.

When no item is selected, you can display custom text within the editor’s edit box. To do this, assign the required string to the RepositoryItem.NullText property.

The following code snippets (auto-collected from DevExpress Examples) contain references to the MRUEdit class.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#
VB.NET

how-to-add-a-find-panel-similar-to-the-one-provided-by-gridcontrol-to-treelist-e2877/CS/WindowsApplication3/FindPanel.cs#L23

LayoutControl layoutControl;
MRUEdit searchEdit;
SimpleButton closeButton, findButton, clearButton;

custom-editor-how-to-implement-the-windows-explorer-search-editor-e4059/CS/SearchButton/SearchButtonEdit/SearchButtonEdit.cs#L12

{
    public class SearchButtonEdit : MRUEdit
    {

how-to-customize-the-search-dialog-e1659/CS/SearchFormCustomization/Form1.cs#L57

void OnSearchStringChanged(object sender, EventArgs e) {
    MRUEdit editor = sender as MRUEdit;
    if(patterns.ContainsKey(editor.Text))

custom-editor-how-to-implement-the-windows-explorer-search-editor-e4059/VB/SearchButton/SearchButtonEdit/SearchButtonEdit.vb#L13

Public Class SearchButtonEdit
    Inherits MRUEdit
    #Region "Service"

how-to-add-a-find-panel-similar-to-the-one-provided-by-gridcontrol-to-treelist-e2877/VB/WindowsApplication3/FindPanel.vb#L25

Private layoutControl As LayoutControl
Private searchEdit As MRUEdit
Private closeButton, findButton, clearButton As SimpleButton

how-to-customize-the-search-dialog-e1659/VB/SearchFormCustomization/Form1.vb#L62

Private Sub OnSearchStringChanged(ByVal sender As Object, ByVal e As EventArgs)
    Dim editor As MRUEdit = TryCast(sender, MRUEdit)
    If patterns.ContainsKey(editor.Text) Then