BarEditItem.Edit Property

Specifies an editor associated with the current BarEditItem.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

[SmartTagSearchNestedProperties("Properties editor")]
public virtual RepositoryItem Edit { get; set; }

VB.NET

<SmartTagSearchNestedProperties("Properties editor")>
Public Overridable Property Edit As RepositoryItem

Property Value

Type	Description
RepositoryItem	A RepositoryItem representing a specific item editor.

Remarks

Use this property to specify the type of editor (a RepositoryItem class descendant) to be associated with the BarEditItem object.

Note

An in-place editor (BaseEdit descendant) within a Bar, Menu or Ribbon Control is created from a RepositoryItem descendant and activated only when a corresponding edit box is focused. If the edit box is not focused, the editor doesn’t exist at this point in time. When the edit box loses focus, the corresponding editor is automatically destroyed. So, it’s not possible to access an editor displayed within a Bar/Menu/Ribbon Control unless this editor has focus.

To access and customize a specific in-place editor, first activate the editor via the BarEditItemLink.ShowEditor method. To access the editor, use the BarManager.ActiveEditor property (for the RibbonControl, use the RibbonControl.Manager.ActiveEditor property).

Specific dropdown editors allow their items to be populated from a data source (e.g., a LookUpEdit or CheckedComboBoxEdit). If this editor is embedded into a Bar or Ribbon Control and the corresponding edit box is not focused, changes made to the data source are not reflected by the edit box. To update the edit box, you can use the BarItem.Refresh method.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the Edit property.

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#

winforms-bars-create-baredititem/CS/Form1.cs#L142

item = new DevExpress.XtraBars.BarEditItem(barManager1);
item.Edit = combo;
item.EditValue = "[n/a]";

VB.NET

winforms-bars-create-baredititem/VB/Form1.vb#L137

item = New DevExpress.XtraBars.BarEditItem(barManager1)
item.Edit = combo
item.EditValue = "[n/a]"