É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. 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] Limité à l’une des valeurs suivantes (0 et 1 ne sont pas valides) : |
| ItemHeight |
xs:integer |
No |
Avec ItemWidth, détermine la taille de l’image d’élément affichée dans le contrôle Gallery. [!Note] |
| ItemWidth |
xs:integer |
No |
Avec ItemHeight, détermine la taille de l’image d’élément affichée dans le contrôle Gallery. [!Note] |
| 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. |
| 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. |
| MaxRows |
xs:integer |
No |
Spécifie le nombre maximal de lignes pour la disposition des éléments InRibbonGallery . |
| 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. |
| 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. |
| 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 : |
| Type |
xs:string |
No |
Limité à l’une des valeurs suivantes : |
É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] |
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.

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