MenuGroup, classe

Article
08/10/2011

Représente un groupe d'éléments de menu.

Hiérarchie d'héritage

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

Espace de noms : Microsoft.Windows.Design.Interaction
Assembly : Microsoft.Windows.Design.Interaction (dans Microsoft.Windows.Design.Interaction.dll)

Syntaxe

'Déclaration
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

Le type MenuGroup expose les membres suivants.

Constructeurs

	Nom	Description
	MenuGroup(String)	Initialise une nouvelle instance de la classe MenuGroup qui a le nom de groupe spécifié.
	MenuGroup(String, String)	Initialise une nouvelle instance de la classe MenuGroup qui a le nom de groupe spécifié et un nom complet.

Début

Propriétés

	Nom	Description
	Context	Obtient le contexte d'édition actuel. (Hérité de MenuBase.)
	DisplayName	Obtient ou définit le texte localisé à afficher pour l'élément de menu. (Hérité de MenuBase.)
	HasDropDown	Obtient ou définit une valeur qui indique si les éléments de menu dans la collection Items sont ajoutés à un sous-menu.
	Items	Obtient une liste d'éléments de menu à afficher comme frères et sœurs dans le même groupe de menus.
	Name	Obtient ou définit l'identificateur unique de l'élément de menu. (Hérité de MenuBase.)

Début

Méthodes

	Nom	Description
	Equals	Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
	Finalize	Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
	GetHashCode	Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	MemberwiseClone	Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
	OnPropertyChanged	Déclenche l'événement PropertyChanged. (Hérité de MenuBase.)
	ToString	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)

Début

Événements

	Nom	Description
	PropertyChanged	Se produit lorsqu'une propriété a été modifiée. (Hérité de MenuBase.)

Début

Notes

Les éléments de menu sont représentés par la classe MenuAction. Un groupe de menus peut avoir une collection d'éléments de menu directement dans le menu ou dans un sous-menu également appelé menu volant. Définissez la propriété HasDropDown pour afficher les éléments de menu d'écran dans un sous-menu.

Pour afficher des éléments de menu contextuel, héritez de la classe PrimarySelectionContextMenuProvider et créez des éléments MenuAction, ainsi qu'un MenuGroup associé.

Exemples

L'exemple de code suivant indique comment configurer deux éléments MenuAction et les assigner à un MenuGroup. Pour plus d'informations, consultez Procédure pas à pas : création d'un fournisseur de menus.

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

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.