Élément SplitButton

Article
06/13/2023

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

Partager via