Bar

BarEditItem.Edit Property

Specifies an editor associated with the current BarEditItem.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v20.1.dll

Declaration

[SmartTagSearchNestedProperties("Properties editor")]
public virtual RepositoryItem Edit { get; set; }
<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.

See Also