Partager via


MenuGroup, classe

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
Méthode publique MenuGroup(String) Initialise une nouvelle instance de la classe MenuGroup qui a le nom de groupe spécifié.
Méthode publique 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
Propriété publique Context Obtient le contexte d'édition actuel. (Hérité de MenuBase.)
Propriété publique DisplayName Obtient ou définit le texte localisé à afficher pour l'élément de menu. (Hérité de MenuBase.)
Propriété publique 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.
Propriété publique Items Obtient une liste d'éléments de menu à afficher comme frères et sœurs dans le même groupe de menus.
Propriété publique Name Obtient ou définit l'identificateur unique de l'élément de menu. (Hérité de MenuBase.)

Début

Méthodes

  Nom Description
Méthode publique Equals Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégée 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.)
Méthode publique GetHashCode Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode protégée OnPropertyChanged Déclenche l'événement PropertyChanged. (Hérité de MenuBase.)
Méthode publique ToString Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)

Début

Événements

  Nom Description
Événement public 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.

Voir aussi

Référence

Microsoft.Windows.Design.Interaction, espace de noms

MenuAction

PrimarySelectionContextMenuProvider

Autres ressources

Procédure pas à pas : création d'un fournisseur de menus