Élément MenuGroup

Article
09/03/2023

Représente un conteneur de contrôles à afficher dans une galerie, un menu ou une barre d’outils.

Usage

<MenuGroup
  Class = "xs:string"
  CommandName = "xs:positiveInteger or xs:string">
  child elements
</MenuGroup>

Attributs

Attribut	Type	Obligatoire	Description
Classe	xs:string	Non	Spécifie la taille et le style de disposition des éléments dans l’interface utilisateur du menu. Une ressource d’image peut être fournie en deux tailles (grande et petite) et associée à l’élément dans le balisage à l’aide des éléments de propriété Command.LargeImages et Command.SmallImages . Si une seule image est fournie, l’infrastructure la redimensionne si nécessaire. Limité à l’une des valeurs suivantes : (StandardItems) Par défaut. Style : petite image et texte mis en évidence. (MajorItems) Style : image grande et texte en gras. Remarque : Si MenuGroup est un enfant d’ApplicationMenu, l’attribut Class est ignoré et un style de `MajorItems` est appliqué par l’infrastructure.
CommandName	xs:positiveInteger ou xs:string	Non	Associe l’élément à une commande. (xs:positiveInteger ou xs:string) Une chaîne, une valeur entière comprise entre 2 et 59999, inclusive, ou une valeur hexadécimale comprise entre 0x2 et 0xea5f, inclusive. La valeur doit être unique dans le document XML du ruban. Longueur maximale : 100 caractères.

Éléments enfants

Élément	Description
Button	Peut se produire une ou plusieurs fois
Case	Peut se produire une ou plusieurs fois
ComboBox	Peut se produire une ou plusieurs fois
DropDownButton	Peut se produire une ou plusieurs fois
DropDownColorPicker	Peut se produire une ou plusieurs fois
DropDownGallery	Peut se produire une ou plusieurs fois
FontControl	Peut se produire au plus une fois
SplitButton	Peut se produire une ou plusieurs fois
SplitButtonGallery	Peut se produire une ou plusieurs fois
ToggleButton	Peut se produire une ou plusieurs fois

Éléments parents

Élément
ApplicationMenu
ContextMenu
DropDownButton
DropDownGallery.MenuGroups
InRibbonGallery.MenuGroups
MiniToolbar
SplitButton.MenuGroups
SplitButtonGallery.MenuGroups

Remarques

Obligatoire.

Doit se produire au moins une fois pour chaque élément ApplicationMenu, ContextMenu, DropDownButton, DropDownGallery.MenuGroups, InRibbonGallery.MenuGroups, SplitButton.MenuGroups, MiniToolbar ou SplitButtonGallery.MenuGroups .

Si ApplicationMenu est l’élément parent, MenuGroup est limité aux éléments enfants suivants : Button, DropDownButton, DropDownGallery, SplitButton ou SplitButtonGallery.

Si ContextMenu, DropDownButton, DropDownGallery.MenuGroups, InRibbonGallery.MenuGroups, SplitButton.MenuGroups ou SplitButtonGallery.MenuGroups est l’élément parent, MenuGroup est limité aux éléments enfants suivants : Button, CheckBox, DropDownButton, DropDownColorPicker, DropDownGallery, SplitButton, SplitButtonGalleryou ToggleButton.

Si MiniToolbar est l’élément parent, MenuGroup est limité aux éléments enfants suivants : Button, CheckBox, ComboBox, DropDownButton, DropDownColorPicker, DropDownGallery, FontControl, Spinner, SplitButton, SplitButton, SplitButtonGallery ou ToggleButton.

L’attribut Class n’est pas obligatoire lorsque ApplicationMenu est l’élément parent. L’infrastructure applique une valeur de MajorItems pour l’attribut Class.

Lorsque ApplicationMenu est l’élément parent, l’attribut Class n’est pas requis.

Exemples

L’exemple suivant illustre le balisage de base pour SplitButton avec un élément MenuGroup .

Cette section de code présente les déclarations SplitButton et MenuGroup Command avec une grande et une petite ressource d’image. Un groupe associé qui agit comme conteneur parent pour l’élément SplitButton est également déclaré.

<!-- SplitButton -->
<Command Name="cmdSplitButtonGroup"
         Symbol="cmdSplitButtonGroup"
         Comment="SplitButton Group"
         LabelTitle="SplitButton"/>
<Command Name="cmdSplitButton"
         Symbol="cmdSplitButton"
         Comment="SplitButton"
         LabelTitle="SplitButton"/>
<Command Name="cmdSBButtonItem"
         Symbol="cmdSBButtonItem"
         Comment="SBButtonItem"
         LabelTitle="SB ButtonItem"/>
<Command Name="cmdSBButton1"
         Symbol="cmdSBButton1"
         Comment="SBButton1"
         LabelTitle="SB Button">
  <Command.LargeImages>
    <Image Source="res/copyL_32.bmp"/>
  </Command.LargeImages>
  <Command.SmallImages>
    <Image Source="res/copyS_16.bmp"/>
  </Command.SmallImages>
  <Command.LargeHighContrastImages>
    <Image Source="res/copyLHC_32.bmp"/>
  </Command.LargeHighContrastImages>
  <Command.SmallHighContrastImages>
    <Image Source="res/copySHC_16.bmp"/>
  </Command.SmallHighContrastImages>
</Command>
<Command Name="cmdSBMajorItems"
         Comment="Major Items Category"
         LabelTitle="Major Items"/>
<Command Name="cmdSBStandardItems"
         Comment="Standard Items Category"
         LabelTitle="Standard Items"/>

Cette section de code présente les déclarations de contrôle SplitButton et MenuGroup avec StandardItems et MajorItems.

<Group CommandName="cmdSplitButtonGroup">
  <SplitButton CommandName="cmdSplitButton">
    <SplitButton.ButtonItem>
      <Button CommandName="cmdSBButtonItem"/>
    </SplitButton.ButtonItem>
    <SplitButton.MenuGroups>
      <MenuGroup CommandName="cmdSBMajorItems" 
                 Class="MajorItems">
        <Button CommandName="cmdSBButton1"/>
        <Button CommandName="cmdSBButton1"/>
      </MenuGroup>
      <MenuGroup CommandName="cmdSBStandardItems"
                 Class="StandardItems">
        <Button CommandName="cmdSBButton1"/>
        <Button CommandName="cmdSBButton1"/>
      </MenuGroup>
      <MenuGroup Class="StandardItems">
        <Button CommandName="cmdSBButton1"/>
        <Button CommandName="cmdSBButton1"/>
      </MenuGroup>
    </SplitButton.MenuGroups>
  </SplitButton>
</Group>

Informations sur les éléments

Système minimum pris en charge : Windows 7
Peut être vide : Non

Voir aussi

Spécification des ressources d’image de ruban
Groupe de menus

Share via