This documentation is archived and is not being maintained.

ContextMenu Class

Updated: September 2010

Represents a pop-up menu that enables a control to expose functionality that is specific to the context of the control.

Namespace:  System.Windows.Controls
Assembly:  PresentationFramework (in PresentationFramework.dll)

public ref class ContextMenu : public MenuBase

Content Model:  ContextMenu is a ItemsControl. Its content properties are Items and ItemsSource. For more information on the content model for ContextMenu, see Controls Content Model Overview.

The properties of the ContextMenu class are used to define the position and behavior of the ContextMenu.

A FrameworkElement or FrameworkContentElement can have a ContextMenu. If you assign a ContextMenu to the FrameworkElement::ContextMenu or FrameworkContentElement::ContextMenu property, the ContextMenuService class handles context menu operations in response to user interaction. Part of the work the ContextMenuService does is opening the ContextMenu when the user clicks the right mouse button over the control.

The following properties are defined by the ContextMenu and ContextMenuService classes. If any of these properties are set on both ContextMenu and the ContextMenuService, the property value from the ContextMenuService is used.

A ContextMenu is automatically placed inside a Popup control. This behavior cannot be changed.

Dependency properties for this control might be set by the control’s default style. If a property is set by a default style, the property might change from its default value when the control appears in the application. The default style is determined by which desktop theme is used when the application is running. For more information, see Themes.

The following example creates a ContextMenu that manipulates the text of a TextBox. The example demonstrates how to subscribe to and handle the events of MenuItem objects in a ContextMenu.

<TextBox Name="textBox1"
         Margin="10, 10, 5, 5" Grid.Row="7">
  The quick brown fox jumps over the lazy dog.
      <MenuItem Header="_Bold"
                Unchecked="Bold_Unchecked" />
      <MenuItem Header="_Italic"
                Unchecked="Italic_Unchecked" />
      <Separator />
      <MenuItem Header="I_ncrease Font Size"
                Click="IncreaseFont_Click" />
      <MenuItem Header="_Decrease Font Size"
                Click="DecreaseFont_Click" />

No code example is currently available or this language may not be supported.


Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0




September 2010

Improved example.

Customer feedback.

February 2009

Described how default styles change dependency properties.

Customer feedback.