Partager via


Élément SplitButtonGallery

Représente un contrôle Galerie de boutons fractionnés avec un menu déroulant basé sur la galerie.

Usage

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

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.
Les espaces blancs sont valides et ignorés.
Longueur maximale : 250 caractères.
CommandName
xs:positiveInteger ou xs:string
Non
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.
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

SplitButton
Peut se produire une ou plusieurs fois

SplitButtonGallery.MenuGroups
Doit se produire exactement une seule fois

SplitButtonGallery.MenuLayout
Peut se produire au plus une 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 uniquement pris en charge 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, Group, MenuGroup ou SplitButton .

SplitButtonGallery prend en charge les modes d’application.

UI_PKEY_BooleanValue est utilisé par une application pour interroger l’état bascule pour le contrôle de bouton d’un SplitButtonGallery.

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

capture d’écran d’un contrôle de galerie de boutons partagés dans microsoft paint pour windows 7.

Exemples

L’exemple suivant illustre le balisage de base pour la galerie de boutons fractionnés.

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

<!-- SplitButtonGallery -->
<Command Name="cmdSplitButtonGalleryGroup"
         Symbol="cmdSplitButtonGalleryGroup"
         Comment="SplitButtonGallery Group"
         LabelTitle="SplitButtonGallery"/>
<Command Name="cmdSplitButtonGallery"
         Symbol="cmdSplitButtonGallery"
         Comment="SplitButtonGallery"
         LabelTitle="SplitButtonGallery"/>

Cette section de code affiche les déclarations de contrôle SplitButtonGallery .

<!-- SplitButtonGallery -->
<Group CommandName="cmdSplitButtonGalleryGroup">
  <SplitButtonGallery CommandName="cmdSplitButtonGallery">
    <SplitButtonGallery.MenuLayout>
      <FlowMenuLayout Rows="2"
                      Columns="3"
                      Gripper="None"/>
    </SplitButtonGallery.MenuLayout>
    <SplitButtonGallery.MenuGroups>
      <MenuGroup>
        <Button CommandName="cmdButton1"></Button>
        <Button CommandName="cmdButton2"></Button>
      </MenuGroup>
      <MenuGroup>
        <Button CommandName="cmdButton3"></Button>
      </MenuGroup>
    </SplitButtonGallery.MenuGroups>
  </SplitButtonGallery>
</Group>

Informations sur les éléments

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

Voir aussi

Contrôle Galerie de boutons fractionnés

Utilisation des galeries

SetModes

Exemple de galerie