Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Expand]Controls and Libraries
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Collapse]API Reference
  [Expand]DevExpress.Charts.Designer
  [Expand]DevExpress.Mvvm.UI
  [Expand]DevExpress.Mvvm.UI.Interactivity
  [Expand]DevExpress.Mvvm.UI.ModuleInjection
  [Expand]DevExpress.Xpf.Accordion
  [Expand]DevExpress.Xpf.Bars
  [Expand]DevExpress.Xpf.Carousel
  [Expand]DevExpress.Xpf.Charts
  [Expand]DevExpress.Xpf.Charts.Localization
  [Expand]DevExpress.Xpf.Charts.RangeControlClient
  [Expand]DevExpress.Xpf.ChunkList
  [Expand]DevExpress.Xpf.Controls
  [Expand]DevExpress.Xpf.Core
  [Expand]DevExpress.Xpf.Core.ConditionalFormatting
  [Expand]DevExpress.Xpf.Core.DataSources
  [Expand]DevExpress.Xpf.Core.ServerMode
  [Expand]DevExpress.Xpf.Data
  [Expand]DevExpress.Xpf.DataAccess
  [Expand]DevExpress.Xpf.DataAccess.DataSourceWizard
  [Expand]DevExpress.Xpf.Diagram
  [Collapse]DevExpress.Xpf.Docking
   [Expand]AutoHideGroup Class
   [Expand]AutoHideGroupCollection Class
    AutoHideType Enumeration
   [Expand]BaseLayoutItem Class
   [Expand]BaseLayoutItemCollection Class
    CaptionAlignMode Enumeration
    CaptionLocation Enumeration
   [Expand]ClosedPanelCollection Class
    ClosePageButtonShowMode Enumeration
    ClosingBehavior Enumeration
   [Expand]ContentItem Class
   [Expand]DefaultMenuItemNames Class
   [Expand]DockController Class
   [Expand]DockControllerBase Class
   [Expand]DockingDocumentUIService Class
    DockingStyle Enumeration
   [Collapse]DockLayoutManager Class
     DockLayoutManager Members
     DockLayoutManager Constructor
    [Expand]DockLayoutManager Properties
    [Collapse]DockLayoutManager Events
      BeforeItemAdded Event
      CustomizationFormVisibleChanged Event
      DockItemActivated Event
      DockItemActivating Event
      DockItemClosed Event
      DockItemClosing Event
      DockItemCollapsed Event
      DockItemDocking Event
      DockItemDragging Event
      DockItemEndDocking Event
      DockItemExpanded Event
      DockItemHidden Event
      DockItemHiding Event
      DockItemRestored Event
      DockItemRestoring Event
      DockItemStartDocking Event
      DockOperationCompleted Event
      DockOperationStarting Event
      IsCustomizationChanged Event
      ItemIsVisibleChanged Event
      LayoutItemActivated Event
      LayoutItemActivating Event
      LayoutItemEndRenaming Event
      LayoutItemHidden Event
      LayoutItemMoved Event
      LayoutItemRestored Event
      LayoutItemSelectionChanged Event
      LayoutItemSelectionChanging Event
      LayoutItemSizeChanged Event
      LayoutItemStartRenaming Event
      MDIItemActivated Event
      MDIItemActivating Event
      Merge Event
      RequestUniqueName Event
      ShowingDockHints Event
      ShowingMenu Event
      ShowInvisibleItemsChanged Event
      UnMerge Event
    [Expand]DockLayoutManager Methods
    DockOperation Enumeration
   [Expand]DocumentGroup Class
   [Expand]DocumentPanel Class
   [Expand]EmptySpaceItem Class
   [Expand]FixedItem Class
    FixedItemStyle Enumeration
   [Expand]FloatGroup Class
   [Expand]FloatGroupCollection Class
    FloatingMode Enumeration
    GroupBorderStyle Enumeration
    ImageLocation Enumeration
   [Expand]LabelItem Class
   [Expand]LayoutControlItem Class
   [Expand]LayoutController Class
   [Expand]LayoutGroup Class
   [Expand]LayoutPanel Class
   [Expand]LayoutSplitter Class
    MDIState Enumeration
    MDIStyle Enumeration
   [Expand]RestoreLayoutOptions Class
   [Expand]SeparatorItem Class
   [Expand]TabbedDocumentUIService Class
   [Expand]TabbedGroup Class
  [Expand]DevExpress.Xpf.Docking.Base
  [Expand]DevExpress.Xpf.DocumentViewer
  [Expand]DevExpress.Xpf.DXBinding
  [Expand]DevExpress.Xpf.Editors
  [Expand]DevExpress.Xpf.Editors.DateNavigator
  [Expand]DevExpress.Xpf.Editors.ExpressionEditor
  [Expand]DevExpress.Xpf.Editors.ExpressionEditor.Native
  [Expand]DevExpress.Xpf.Editors.Filtering
  [Expand]DevExpress.Xpf.Editors.Flyout
  [Expand]DevExpress.Xpf.Editors.Flyout.Native
  [Expand]DevExpress.Xpf.Editors.Helpers
  [Expand]DevExpress.Xpf.Editors.Popups
  [Expand]DevExpress.Xpf.Editors.RangeControl
  [Expand]DevExpress.Xpf.Editors.Settings
  [Expand]DevExpress.Xpf.Editors.Validation
  [Expand]DevExpress.Xpf.ExpressionEditor
  [Expand]DevExpress.Xpf.Gauges
  [Expand]DevExpress.Xpf.Gauges.Localization
  [Expand]DevExpress.Xpf.Grid
  [Expand]DevExpress.Xpf.Grid.ConditionalFormatting
  [Expand]DevExpress.Xpf.Grid.LookUp
  [Expand]DevExpress.Xpf.Grid.TreeList
  [Expand]DevExpress.Xpf.Layout.Core
  [Expand]DevExpress.Xpf.LayoutControl
  [Expand]DevExpress.Xpf.Map
  [Expand]DevExpress.Xpf.NavBar
  [Expand]DevExpress.Xpf.Navigation
  [Expand]DevExpress.Xpf.PdfViewer
  [Expand]DevExpress.Xpf.PivotGrid
  [Expand]DevExpress.Xpf.PivotGrid.Printing
  [Expand]DevExpress.Xpf.Printing
  [Expand]DevExpress.Xpf.Printing.Parameters
  [Expand]DevExpress.Xpf.Printing.Parameters.Models
  [Expand]DevExpress.Xpf.Printing.PreviewControl
  [Expand]DevExpress.Xpf.Printing.PreviewControl.Bars
  [Expand]DevExpress.Xpf.Prism
  [Expand]DevExpress.Xpf.PropertyGrid
  [Expand]DevExpress.Xpf.Reports.UserDesigner
  [Expand]DevExpress.Xpf.Reports.UserDesigner.Extensions
  [Expand]DevExpress.Xpf.Reports.UserDesigner.Localization
  [Expand]DevExpress.Xpf.Reports.UserDesigner.ReportWizard
  [Expand]DevExpress.Xpf.Reports.UserDesigner.ReportWizard.Pages
  [Expand]DevExpress.Xpf.Ribbon
  [Expand]DevExpress.Xpf.RichEdit
  [Expand]DevExpress.Xpf.RichEdit.Menu
  [Expand]DevExpress.Xpf.Scheduler
  [Expand]DevExpress.Xpf.Scheduler.Drawing
  [Expand]DevExpress.Xpf.Scheduler.Menu
  [Expand]DevExpress.Xpf.Scheduler.Reporting
  [Expand]DevExpress.Xpf.Scheduler.UI
  [Expand]DevExpress.Xpf.Scheduling
  [Expand]DevExpress.Xpf.Scheduling.Editors
  [Expand]DevExpress.Xpf.Scheduling.Reporting
  [Expand]DevExpress.Xpf.Scheduling.Visual
  [Expand]DevExpress.Xpf.SpellChecker
  [Expand]DevExpress.Xpf.Spreadsheet
  [Expand]DevExpress.Xpf.Spreadsheet.Menu
  [Expand]DevExpress.Xpf.TreeMap
  [Expand]DevExpress.Xpf.Utils.Themes
  [Expand]DevExpress.Xpf.WindowsUI
  [Expand]DevExpress.Xpf.WindowsUI.Internal
  [Expand]DevExpress.Xpf.WindowsUI.Navigation
  [Expand]DevExpress.XtraRichEdit
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

DockLayoutManager.ShowingMenu Event

Fires before showing a context menu, and allows it to be customized.

Namespace:DevExpress.Xpf.Docking
Assembly:DevExpress.Xpf.Docking.v17.2.dll

Expanded Syntax

Expanded Event Data

The event handler receives an argument of type ShowingMenuEventArgs containing data related to this event.

The following ShowingMenuEventArgs properties provide information specific to this event.
Property Description
ActionList
Handled Gets or sets a value that indicates the present state of the event handling for a routed event as it travels the route.
Items
Menu
OriginalSource Gets the original reporting source as determined by pure hit testing, before any possible System.Windows.RoutedEventArgs.Source adjustment by a parent class.
RoutedEvent Gets or sets the System.Windows.RoutedEventArgs.RoutedEvent associated with this System.Windows.RoutedEventArgs instance.
Show
Source Gets or sets a reference to the object that raised the event.
TargetElement

Expanded Remarks

This event allows you to respond to a context menu being invoked. You can handle it to change a menu, or prevent it from being displayed. To prevent the menu from being displayed, set the event's Show parameter to false.

To change the menu, add bar customization actions to the event's ActionList parameter. Bar customization actions are objects that implement the IBarManagerControllerAction interface. See ContextMenuCustomizations for a list of most commonly used customization actions. To get information on all the available actions, see Bar Actions.

To customize context menus in XAML, use the ContextMenuCustomizations and ItemSelectorMenuCustomizations properties.

Expanded Example

Show Me

A complete sample project is available in the DevExpress Code Examples database at http://www.devexpress.com/example=E1751.

This example shows how to customize a context menu for a LayoutPanel via the DockManager.ShowingMenu event. The menu is customized using bar customization actions. In the example, two actions are created:

- a BarButtonItem object represents an action that adds the BarButtonItem object to the menu

- an InsertBarItemLinkAction object represents an action that inserts a bar item link to the menu (in the example, the inserted link represents a separator).

Actions are added to the event's ActionList parameter and are executed after the ShowingMenu event handler is completed.

The following image shows the menu containing the custom items:

Expanded See Also

How would you rate this topic?​​​​​​​