Élément MenuGroup

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

Utilisation

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

Attributs

Attribut Type Obligatoire Description
Classe
xs:string
No
Spécifie la taille et le style de disposition des éléments de l’interface utilisateur du menu.
Une ressource d’image peut être fournie en deux tailles (grandes et petites) 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 le redimensionne en fonction des besoins.
Limité à l’une des valeurs suivantes :

(StandardItems)
Par défaut.
Style : petite image et texte détérioté.
Screen shot of a StandardItems button.
(MajorItems)
Style : image volumineuse et texte en gras.
[! Remarque]
Si MenuGroup est un enfant d’ApplicationMenu, l’attribut classe est ignoré et un style est MajorItems appliqué par l’infrastructure.

Screen shot of a MajorItems button.
CommandName
xs:positiveInteger ou xs:string
No
Associe l’élément à une commande.

(xs:positiveInteger ou xs:string)
Chaîne, valeur entière comprise entre 2 et 59999, inclusive ou 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

CheckBox
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

Notes

Obligatoire.

Doit se produire au moins une fois pour chaque 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, SplitButtonGallery, SplitButtonGallery, SplitButtonGallery ou 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, SplitButtonGallery ou ToggleButton.

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

Quand ApplicationMenu est l’élément parent, l’attribut Classe n’est pas obligatoire.

Exemples

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

Cette section du code affiche les déclarations de commande SplitButton et MenuGroup avec une ressource d’image volumineuse et petite. 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 du code affiche les déclarations de contrôle SplitButton et MenuGroup avec les deux 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 du ruban

Groupe de menus