MenuGroup Class
Visual Studio 2010
Represents a group of menu items.
System.Object
Microsoft.Windows.Design.Interaction.MenuBase
Microsoft.Windows.Design.Interaction.MenuGroup
Microsoft.Windows.Design.Interaction.MenuBase
Microsoft.Windows.Design.Interaction.MenuGroup
Assembly: Microsoft.Windows.Design.Interaction (in Microsoft.Windows.Design.Interaction.dll)
The MenuGroup type exposes the following members.
| Name | Description | |
|---|---|---|
![]() | MenuGroup(String) | Initializes a new instance of the MenuGroup class that has the specified group name. |
![]() | MenuGroup(String, String) | Initializes a new instance of the MenuGroup class that has the specified group name and display name. |
| Name | Description | |
|---|---|---|
![]() | Context | Gets the current editing context. (Inherited from MenuBase.) |
![]() | DisplayName | Gets or sets the localized text to display for the menu item. (Inherited from MenuBase.) |
![]() | HasDropDown | Gets or sets a value indicating whether the menu items in the Items collection are added to a submenu. |
![]() | Items | Gets a list of menu items to display as siblings within the same menu group. |
![]() | Name | Gets or sets the unique identifier for the menu item. (Inherited from MenuBase.) |
| Name | Description | |
|---|---|---|
![]() | Equals | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() | OnPropertyChanged | Raises the PropertyChanged event. (Inherited from MenuBase.) |
![]() | ToString | Returns a string that represents the current object. (Inherited from Object.) |
Menu items are represented by the MenuAction class. A menu group can have a collection of menu items directly on the menu or as a submenu, which is also called a flyout menu. Set the HasDropDown property to display menu items in a submenu.
To show context menu items, inherit from the PrimarySelectionContextMenuProvider class and create MenuAction items and an associated MenuGroup.
The following code example shows how to set up two MenuAction items and assign them to a MenuGroup. For more information, see Walkthrough: Creating a Menu Provider.
// The provider's constructor sets up the MenuAction objects // and the the MenuGroup which holds them. public CustomContextMenuProvider() { // Set up the MenuAction which sets the control's // background to Blue. setBackgroundToBlueMenuAction = new MenuAction("Blue"); setBackgroundToBlueMenuAction.Checkable = true; setBackgroundToBlueMenuAction.Execute += new EventHandler<MenuActionEventArgs>(SetBackgroundToBlue_Execute); // Set up the MenuAction which sets the control's // background to its default value. clearBackgroundMenuAction = new MenuAction("Cleared"); clearBackgroundMenuAction.Checkable = true; clearBackgroundMenuAction.Execute += new EventHandler<MenuActionEventArgs>(ClearBackground_Execute); // Set up the MenuGroup which holds the MenuAction items. MenuGroup backgroundFlyoutGroup = new MenuGroup("SetBackgroundsGroup", "Set Background"); // If HasDropDown is false, the group appears inline, // instead of as a flyout. Set to true. backgroundFlyoutGroup.HasDropDown = true; backgroundFlyoutGroup.Items.Add(setBackgroundToBlueMenuAction); backgroundFlyoutGroup.Items.Add(clearBackgroundMenuAction); this.Items.Add(backgroundFlyoutGroup); // The UpdateItemStatus event is raised immediately before // this provider shows its tabs, which provides the opportunity // to set states. UpdateItemStatus += new EventHandler<MenuActionEventArgs>( CustomContextMenuProvider_UpdateItemStatus); }
