Partager via


É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.

capture d’écran d’un contrôle de galerie de liste déroulante 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