RepositoryItemTextEdit.BeforeShowMenu Event

Occurs before the editor's context menu is displayed.

Namespace: DevExpress.XtraEditors.Repository

Assembly: DevExpress.XtraEditors.v20.1.dll

Declaration

[DXCategory("Events")]
public event BeforeShowMenuEventHandler BeforeShowMenu
<DXCategory("Events")>
Public Event BeforeShowMenu As BeforeShowMenuEventHandler

Event Data

The BeforeShowMenu event's data class is DevExpress.XtraEditors.Controls.BeforeShowMenuEventArgs.

Remarks

You can handle this event to customize the editor's context menu. The event fires each time the menu is about to be displayed.

The editor's context menu, specified by the event's Menu parameter, is represented by the DXPopupMenu class. Menu items are represented by the DXMenuItem, DXMenuCheckItem and DXSubMenuItem objects.

NOTE

On Windows 7 x64, if an exception is raised within a BeforeShowMenu event handler, it is suppressed by the .NET Framework. This behavior is not reproducible in other Windows OS versions.

Examples

The following code shows how to prevent an editor's standard context menu from being displayed via the RepositoryItemTextEdit.BeforeShowMenu event.

private void textEdit1_Properties_BeforeShowMenu(object sender, 
DevExpress.XtraEditors.Controls.BeforeShowMenuEventArgs e) {
    e.Menu.Items.Clear();
}
See Also