Élément InRibbonGallery

Représente la Galerie dans le ruban, un contrôle basé sur la galerie qui expose un sous-ensemble par défaut d’éléments directement dans le ruban. Tous les éléments restants sont affichés lorsque l’utilisateur clique sur un bouton de menu déroulant.

Utilisation

<InRibbonGallery
  CommandName = "xs:positiveInteger or xs:string"
  HasLargeItems = "Boolean"
  ItemHeight = "xs:integer"
  ItemWidth = "xs:integer"
  MinColumnsLarge = "xs:integer"
  MaxColumnsMedium = "xs:integer"
  MinColumnsMedium = "xs:integer"
  MaxColumns = "xs:integer"
  MaxRows = "xs:integer"
  TextPosition = "TextPositionType"
  Type = "xs:string">
  child elements
</InRibbonGallery>

Attributs

Attribut Type Obligatoire Description
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 inclus.
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 de grande taille ou de petite taille de la commande est affichée dans le contrôle Gallery.
[!Note]
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) :

:
Par défaut.
fausses
ItemHeight
xs:integer
No
Avec ItemWidth, détermine la taille de l’image d’élément affichée dans le contrôle Gallery.
[!Note]
S’applique uniquement aux galeries où la valeur de l’attribut type est égale à Item.


(XS : Integer)
La valeur par défaut est -1.
ItemWidth
xs:integer
No
Avec ItemHeight, détermine la taille de l’image d’élément affichée dans le contrôle Gallery.
[!Note]
S’applique uniquement aux galeries où la valeur de l’attribut type est égale à Item.


(XS : Integer)
La valeur par défaut est -1.
MaxColumns
xs:integer
No
Spécifie le nombre maximal de colonnes que le InRibbonGallery affiche, par exemple, dans la liste déroulante grande disposition de groupe.

(XS : Integer)
MaxColumnsMedium
xs:integer
No
Spécifie le nombre maximal de colonnes que le InRibbonGallery affiche dans la disposition de groupe de taille moyenne , avant de passer à une grande disposition.

(XS : Integer)
MaxRows
xs:integer
No
Spécifie le nombre maximal de lignes pour la disposition des éléments InRibbonGallery .

(XS : Integer)
La valeur par défaut est 1.
MinColumnsLarge
xs:integer
No
Spécifie le nombre minimal de colonnes que le InRibbonGallery affiche dans la grande disposition de groupe, avant de passer au mode moyen.

(XS : Integer)
MinColumnsMedium
xs:integer
No
Spécifie le nombre minimal de colonnes que le InRibbonGallery affiche dans la disposition de groupe de taille moyenne , avant de basculer vers Small.

(XS : Integer)
TextPosition
TextPositionType
No
Spécifie l’emplacement d’affichage de l’étiquette de l’élément par rapport à l’image.
Limité à l’une des valeurs suivantes :

Ballon
Cuir
Gauche
Éviter
Approprié
Coin
Type
xs:string
No
Limité à l’une des valeurs suivantes :

Contenus
Commandes

Éléments enfants

Élément Description
Activé
Peut se produire une ou plusieurs fois

InRibbonGallery.MenuGroups
Doit se produire exactement une fois

InRibbonGallery.MenuLayout
Peut se produire au plus une fois

Bouton
Peut se produire une ou plusieurs 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
QuickAccessToolbar.ApplicationDefaults
[!Note]
Windows 8 et versions ultérieures.


Remarques

Optionnel.

Peut se produire au plus une fois pour chaque ControlGroup ou élément de groupe .

la capture d’écran suivante illustre le contrôle de galerie ruban dans le ruban dans Microsoft Paint pour Windows 7.

capture d’écran d’un contrôle de galerie dans le ruban dans le ruban Microsoft Paint.

Exemples

L’exemple suivant illustre le balisage de base pour une Galerie dans le ruban.

Cette section de code montre les déclarations de commande InRibbonGallery , avec un groupe associé qui agit en tant que conteneur parent de l’élément InRibbonGallery .

<!-- InRibbonGallery -->
<Command Name="cmdInRibbonGalleryGroup"
         Symbol="cmdInRibbonGalleryGroup"
         Comment="InRibbonGallery Group"
         LabelTitle="InRibbonGallery"/>
<Command Name="cmdInRibbonGallery"
         Symbol="cmdInRibbonGallery"
         Comment="InRibbonGallery"
         LabelTitle="InRibbonGallery"/>

Cette section de code montre les déclarations de contrôle InRibbonGallery .

<!-- InRibbonGallery -->
<Group CommandName="cmdInRibbonGalleryGroup" SizeDefinition="OneInRibbonGallery">
  <InRibbonGallery CommandName="cmdInRibbonGallery"
                   MaxColumns="10"
                   MaxColumnsMedium="5"
                   MinColumnsLarge="5"
                   MinColumnsMedium="3"
                   Type="Items">
    <InRibbonGallery.MenuLayout>
      <VerticalMenuLayout Rows="2"
                          Gripper="Vertical"/>
    </InRibbonGallery.MenuLayout>
    <InRibbonGallery.MenuGroups>
      <MenuGroup>
        <Button CommandName="cmdButton1"></Button>
        <Button CommandName="cmdButton2"></Button>
      </MenuGroup>
      <MenuGroup>
        <Button CommandName="cmdButton3"></Button>
      </MenuGroup>
    </InRibbonGallery.MenuGroups>            
  </InRibbonGallery>
</Group>

Informations sur les éléments

  • système minimal pris en charge: Windows 7
  • Peut être vide: non

Voir aussi

Contrôle de galerie dans le ruban

Utilisation des galeries

Exemple de Galerie