Élément DropDownGallery

Représente un contrôle Galerie déroulante avec un menu basé sur la galerie.

Usage

<DropDownGallery
  ApplicationModes = "xs:string"
  CommandName = "xs:positiveInteger or xs:string"
  HasLargeItems = "Boolean"
  ItemHeight = "xs:integer"
  ItemWidth = "xs:integer"
  TextPosition = "TextPositionType"
  Type = "xs:string">
  child elements
</DropDownGallery>

Attributs

Attribut	Type	Obligatoire	Description
ApplicationModes	xs:string	Non	Valide uniquement si MenuGroup est l’élément parent. (xs:string) Chaîne qui contient une liste séparée par des virgules d’entiers compris entre 0 et 31. L’espace blanc est valide et ignoré. Longueur maximale : 250 caractères.
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.
HasLargeItems	Boolean	Non	Détermine si la ressource d’image grande ou petite de la commande s’affiche dans le contrôle galerie. Remarque : S’applique uniquement aux galeries où la valeur de l’attribut Type est égale à Command. Limité à l’une des valeurs suivantes (0 et 1 ne sont pas valides) : (true) Par défaut. (false)
ItemHeight	xs:integer	Non	(xs:integer) La valeur par défaut est -1.
ItemWidth	xs:integer	Non	(xs:integer) La valeur par défaut est -1.
TextPosition	TextPositionType	Non	Limité à l’une des valeurs suivantes : (Bas) (Masquer) (Gauche) (Chevauchement) (À droite) (Haut)
Type	xs:string	Non	Limité à l’une des valeurs suivantes : (Éléments) (Commandes)

Éléments enfants

Élément	Description
Button	Peut se produire une ou plusieurs fois
Case	Peut se produire une ou plusieurs fois
DropDownGallery.MenuGroups	Doit se produire exactement une fois
DropDownGallery.MenuLayout	Peut se produire au plus une fois
SplitButton	Peut se produire une ou plusieurs fois
ToggleButton	Peut se produire une ou plusieurs fois

Éléments parents

Élément	Description
ControlGroup
Groupe
MenuGroup	Lorsqu’il est contenu dans un ApplicationMenu. Cet élément est pris en charge uniquement au premier niveau et ne doit avoir aucun élément enfant.
QuickAccessToolbar.ApplicationDefaults	Remarque : Windows 8 et versions ultérieures.
SplitButton

Remarques

facultatif.

Peut se produire une ou plusieurs fois pour chaque élément ControlGroup, DropDownButton, Group, MenuGroup ou SplitButton .

DropDownGallery prend en charge les modes d’application.

La capture d’écran suivante illustre le contrôle Galerie déroulante du ruban dans Microsoft Paint pour Windows 7.

Exemples

L’exemple suivant illustre le balisage de base pour dropDownGallery.

Cette section de code présente les déclarations de commande DropDownGallery , avec un groupe associé qui agit comme conteneur parent pour l’élément DropDownGallery .

<!-- DropDownGallery -->
<Command Name="cmdDropDownGalleryGroup"
         Symbol="cmdDropDownGalleryGroup"
         Comment="DropDownGallery Group"
         LabelTitle="DropDownGallery"/>
<Command Name="cmdDropDownGallery"
         Symbol="cmdDropDownGallery"
         Comment="DropDownGallery"
         LabelTitle="DropDownGallery"/>

Cette section de code présente les déclarations de contrôle DropDownGallery .

<!-- DropDownGallery -->
<Group CommandName="cmdDropDownGalleryGroup">
  <DropDownGallery CommandName="cmdDropDownGallery"
                   TextPosition="Hide"
                   Type="Commands"
                   ItemHeight="32"
                   ItemWidth="32">
    <DropDownGallery.MenuLayout>
      <FlowMenuLayout Rows="2"
                      Columns="3"
                      Gripper="None"/>
    </DropDownGallery.MenuLayout>
    <DropDownGallery.MenuGroups>
      <MenuGroup>
        <Button CommandName="cmdButton1"></Button>
        <Button CommandName="cmdButton2"></Button>
       </MenuGroup>
       <MenuGroup>
        <Button CommandName="cmdButton3"></Button>
      </MenuGroup>
    </DropDownGallery.MenuGroups>
  </DropDownGallery>
</Group>

Informations sur les éléments

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

Voir aussi

Contrôle Galerie déroulante

Utilisation des galeries

SetModes

Exemple de galerie