DockManager.PopupMenuShowing Event

Occurs when a context menu is about to be displayed.

Namespace: DevExpress.XtraBars.Docking

Assembly: DevExpress.XtraBars.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

[DXCategory("Docking")]
public event PopupMenuShowingEventHandler PopupMenuShowing

VB.NET

<DXCategory("Docking")>
Public Event PopupMenuShowing As PopupMenuShowingEventHandler

Event Data

The PopupMenuShowing event's data class is PopupMenuShowingEventArgs. The following properties provide information specific to this event:

Property	Description
Cancel	Gets or sets a value indicating whether the event should be canceled. Inherited from CancelEventArgs.
Control	Gets the dock control for which the DockManager.PopupMenuShowing event has been fired.
Menu	Gets the popup menu that is to be displayed.
Point	Gets the popup menu’s location.

Remarks

The DockManager objects support context menus for dock panels and auto-hide containers. The PopupMenuShowing event fires when an attempt is made to display such a context menu. You can handle this event to customize the menu (add new items or remove the existing ones). Menu items in the menu are represented by the DXMenuItem class objects and its descendants.

C#

void DockManager1_PopupMenuShowing(object sender, PopupMenuShowingEventArgs e) {
    e.Menu.Remove(DockControllerCommand.Dock);
    //add a custom item
    DXMenuCheckItem checkItem = new DXMenuCheckItem("My Item");
    e.Menu.Items.Add(checkItem);
}

VB.NET

Private Sub DockManager1_PopupMenuShowing(ByVal sender As Object, ByVal e As PopupMenuShowingEventArgs)
    e.Menu.Remove(DockControllerCommand.Dock)
    Dim checkItem As DXMenuCheckItem = New DXMenuCheckItem("My Item")
    e.Menu.Items.Add(checkItem)
End Sub

To prevent the menu from being invoked, set the Allow parameter to false.