Élément SplitButton

  • Article

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