Partager via


Élément SplitButton

Représente un contrôle Bouton partagé standard.

Utilisation

<SplitButton
  ApplicationModes = "xs:string"
  CommandName = "xs:positiveInteger or xs:string">
  child elements
</SplitButton>

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.

Éléments enfants

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

Case
Peut se produire une ou plusieurs fois

DropDownButton
Peut se produire une ou plusieurs fois

DropDownColorPicker
Peut se produire une ou plusieurs fois

DropDownGallery
Peut se produire une ou plusieurs fois

SplitButton
Peut se produire une ou plusieurs fois

SplitButton.ButtonItem
Peut se produire au plus une fois

SplitButton.MenuGroups
Peut se produire au plus une fois

SplitButtonGallery
Peut se produire une ou plusieurs fois

ToggleButton
Peut se produire une ou plusieurs fois

Éléments parents

Élément
ControlGroup
DropDownGallery
Groupe
MenuGroup
SplitButton
SplitButtonGallery

Notes

Optionnel.

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

SplitButton prend en charge les modes d’application lorsqu’il est hébergé dans la colonne de gauche du menu Application.

DropDownGallery et SplitButtonGallery ne sont pas des éléments enfants valides de DropDownButton lorsque DropDownButton est un descendant d’ApplicationMenu.

SplitButton.MenuGroups doit se produire une seule fois si les éléments suivants ne sont pas présents en tant qu’éléments enfants de SplitButton :

Ces contrôles sont traités comme des éléments enfants d’un seul élément SplitButton.MenuGroups par défaut.

Exemples

L’exemple suivant illustre le balisage de base pour le bouton Fractionner.

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

<!-- SplitButton -->
<Command Name="cmdSplitButtonGroup"
         Symbol="cmdSplitButtonGroup"
         Comment="SplitButton Group"
         LabelTitle="SplitButton"/>
<Command Name="cmdSplitButton"
         Symbol="cmdSplitButton"
         Comment="SplitButton"
         LabelTitle="SplitButton"/>
<Command Name="cmdSBButtonItem"
         Symbol="cmdSBButtonItem"
         Comment="SBButtonItem"
         LabelTitle="SB ButtonItem"/>
<Command Name="cmdSBButton1"
         Symbol="cmdSBButton1"
         Comment="SBButton1"
         LabelTitle="SB Button">
  <Command.LargeImages>
    <Image Source="res/copyL_32.bmp"/>
  </Command.LargeImages>
  <Command.SmallImages>
    <Image Source="res/copyS_16.bmp"/>
  </Command.SmallImages>
  <Command.LargeHighContrastImages>
    <Image Source="res/copyLHC_32.bmp"/>
  </Command.LargeHighContrastImages>
  <Command.SmallHighContrastImages>
    <Image Source="res/copySHC_16.bmp"/>
  </Command.SmallHighContrastImages>
</Command>
<Command Name="cmdSBMajorItems"
         Comment="Major Items Category"
         LabelTitle="Major Items"/>
<Command Name="cmdSBStandardItems"
         Comment="Standard Items Category"
         LabelTitle="Standard Items"/>

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

<Group CommandName="cmdSplitButtonGroup">
  <SplitButton CommandName="cmdSplitButton">
    <SplitButton.ButtonItem>
      <Button CommandName="cmdSBButtonItem"/>
    </SplitButton.ButtonItem>
    <SplitButton.MenuGroups>
      <MenuGroup CommandName="cmdSBMajorItems" 
                 Class="MajorItems">
        <Button CommandName="cmdSBButton1"/>
        <Button CommandName="cmdSBButton1"/>
      </MenuGroup>
      <MenuGroup CommandName="cmdSBStandardItems"
                 Class="StandardItems">
        <Button CommandName="cmdSBButton1"/>
        <Button CommandName="cmdSBButton1"/>
      </MenuGroup>
      <MenuGroup Class="StandardItems">
        <Button CommandName="cmdSBButton1"/>
        <Button CommandName="cmdSBButton1"/>
      </MenuGroup>
    </SplitButton.MenuGroups>
  </SplitButton>
</Group>

Informations sur les éléments

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

Voir aussi

Contrôle Fractionner le bouton

SetModes