MenuGroup (Clase)

Artículo
08/10/2011

Representa un grupo de elementos de menú.

Jerarquía de herencia

System.Object
Microsoft.Windows.Design.Interaction.MenuBase
Microsoft.Windows.Design.Interaction.MenuGroup

Espacio de nombres: Microsoft.Windows.Design.Interaction
Ensamblado: Microsoft.Windows.Design.Interaction (en Microsoft.Windows.Design.Interaction.dll)

Sintaxis

'Declaración
Public Class MenuGroup _
    Inherits MenuBase

public class MenuGroup : MenuBase

public ref class MenuGroup : public MenuBase

type MenuGroup =  
    class
        inherit MenuBase
    end

public class MenuGroup extends MenuBase

El tipo MenuGroup expone los siguientes miembros.

Constructores

	Nombre	Descripción
	MenuGroup(String)	Inicializa una nueva instancia de la clase MenuGroup que tiene el nombre de grupo especificado.
	MenuGroup(String, String)	Inicializa una nueva instancia de la clase MenuGroup que tiene el nombre de grupo y el nombre para mostrar especificados.

Arriba

Propiedades

	Nombre	Descripción
	Context	Obtiene el contexto de edición actual. (Se hereda de MenuBase).
	DisplayName	Obtiene o establece el texto localizado que debe mostrarse para el elemento de menú. (Se hereda de MenuBase).
	HasDropDown	Obtiene o establece un valor que indica si los elementos de menú de la colección Items se agregan a un submenú.
	Items	Obtiene una lista de elementos de menú para mostrarse como elementos del mismo nivel en el mismo grupo de menús.
	Name	Obtiene o establece el identificador único del elemento de menú. (Se hereda de MenuBase).

Arriba

Métodos

	Nombre	Descripción
	Equals	Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
	Finalize	Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
	GetHashCode	Actúa como función hash para un tipo concreto. (Se hereda de Object).
	GetType	Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
	MemberwiseClone	Crea una copia superficial del objeto Object actual. (Se hereda de Object).
	OnPropertyChanged	Provoca el evento PropertyChanged. (Se hereda de MenuBase).
	ToString	Devuelve una cadena que representa el objeto actual. (Se hereda de Object).

Arriba

Eventos

	Nombre	Descripción
	PropertyChanged	Se produce cuando ha cambiado una propiedad. (Se hereda de MenuBase).

Arriba

Comentarios

La clase MenuAction representa los elementos de menú. Un grupo de menús puede tener una colección de elementos de menú directamente en el menú o en forma de submenú, que también se conoce como menú emergente. Establezca la propiedad HasDropDown para mostrar elementos de menú en un submenú.

Para mostrar los elementos del menú contextual, herede de la clase PrimarySelectionContextMenuProvider y cree elementos MenuAction y un objeto MenuGroup asociado.

Ejemplos

En el siguiente ejemplo de código se muestra cómo configurar dos elementos MenuAction y asignarlos a MenuGroup. Para obtener más información, vea Tutorial: Crear un proveedor de menús.

' The provider's constructor sets up the MenuAction objects 
' and the the MenuGroup which holds them.
Public Sub New()

    ' Set up the MenuAction which sets the control's 
    ' background to Blue.
    setBackgroundToBlueMenuAction = New MenuAction("Blue")
    setBackgroundToBlueMenuAction.Checkable = True
    AddHandler setBackgroundToBlueMenuAction.Execute, AddressOf SetBackgroundToBlue_Execute

    ' Set up the MenuAction which sets the control's 
    ' background to its default value.
    clearBackgroundMenuAction = New MenuAction("Cleared")
    clearBackgroundMenuAction.Checkable = True
    AddHandler clearBackgroundMenuAction.Execute, AddressOf ClearBackground_Execute

    ' Set up the MenuGroup which holds the MenuAction items.
    Dim backgroundFlyoutGroup As 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)
    Me.Items.Add(backgroundFlyoutGroup)

    ' The UpdateItemStatus event is raised immediately before 
    ' this provider shows its tabs, which provides the opportunity 
    ' to set states.
    AddHandler UpdateItemStatus, AddressOf CustomContextMenuProvider_UpdateItemStatus

End Sub

// 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);
}

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.