Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

DockLayoutManager.ContextMenuCustomizations Property

A collection of modification actions to be performed on context menus for dock panels.

Namespace: DevExpress.Xpf.Docking

Assembly: DevExpress.Xpf.Docking.v24.2.dll

NuGet Package: DevExpress.Wpf.Docking

#Declaration

public BarManagerActionCollection ContextMenuCustomizations { get; }

#Property Value

Type Description
BarManagerActionCollection

A BarManagerActionCollection object that contains modification actions.

#Remarks

Dock panels support context menus, invoked by right-clicking the panel’s caption:

ContextMenu

You can modify these menus by adding modification actions to the ContextMenuCustomizations collection. The actions are represented by objects that implement the DevExpress.Xpf.Bars.IBarManagerControllerAction interface. Some of these objects are:

  • BarItem descendants - Adding this object to the ContextMenuCustomizations collection adds a link to this bar item to the menu.
  • BarItemLink descendants - Adding this object adds a link to an existing bar item to the menu.
  • AddBarItemAction - This action creates a new bar item to an internal bar item collection. However, no link to this item is added to the menu.
  • AddBarItemLinkAction - This action adds a link to an existing bar item to the menu.
  • InsertBarItemLinkAction - This action inserts a bar item link at a specific position within the menu.

For information on all the available customization actions, see Bar Actions.

#Example

This example shows how to customize a panel’s context menu via customization actions.

Menu customization actions are added via the DockLayoutManager.ContextMenuCustomizations collection.

<dxdo:DockLayoutManager.ContextMenuCustomizations>
    <!--Adds a new About menu command at the top-->
    <dxb:BarButtonItem Name="bAbout" CategoryName="Help" Content="About" ItemClick="bAbout_ItemClick" dxb:BarItemLinkActionBase.ItemLinkIndex="0" />
    <!--Add a separator-->
    <dxb:InsertBarItemLinkAction ItemLinkIndex="1">
        <dxb:BarItemLinkSeparator />
    </dxb:InsertBarItemLinkAction>
</dxdo:DockLayoutManager.ContextMenuCustomizations>
See Also