Elemento SplitButton

Articolo
06/13/2023

Rappresenta un controllo pulsante di divisione standard.

Utilizzo

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

Attributi

Attributo	Type	Obbligatoria	Descrizione
ApplicationModes	xs:string	No	Valido solo se MenuGroup è l'elemento padre. (xs:string) Stringa contenente un elenco delimitato da virgole di interi compresi tra 0 e 31. Lo spazio vuoto è valido e ignorato. Lunghezza massima: 250 caratteri.
CommandName	xs:positiveInteger o xs:string	No	Associa l'elemento a un oggetto Command. (xs:positiveInteger o xs:string) Stringa, un valore intero compreso tra 2 e 59999, inclusi o un valore esadecimale compreso tra 0x2 e 0xea5f, inclusi. Il valore deve essere univoco all'interno del documento XML della barra multifunzione. Lunghezza massima: 100 caratteri.

Elementi figlio

Elemento	Descrizione
Button	Può verificarsi una o più volte
CheckBox	Può verificarsi una o più volte
DropDownButton	Può verificarsi una o più volte
DropDownColorPicker	Può verificarsi una o più volte
DropDownGallery	Può verificarsi una o più volte
SplitButton	Può verificarsi una o più volte
SplitButton.ButtonItem	Può verificarsi al massimo una volta
SplitButton.MenuGroups	Può verificarsi al massimo una volta
SplitButtonGallery	Può verificarsi una o più volte
ToggleButton	Può verificarsi una o più volte

Elementi padre

Elemento
ControlGroup
DropDownGallery
Gruppo
Menugroup
SplitButton
SplitButtonGallery

Commenti

Facoltativa.

Può verificarsi una o più volte per ogni elemento ControlGroup, DropDownGallery, Group, MenuGroup, SplitButton o SplitButtonGallery .

SplitButton supporta le modalità applicazione quando è ospitata nella colonna sinistra del menu applicazione.

DropDownGallery e SplitButtonGallery non sono elementi figlio validi di DropDownButton quando DropDownButton è un discendente di ApplicationMenu.

SplitButton.MenuGroups deve verificarsi una volta se gli elementi seguenti non sono presenti come elementi figlio di SplitButton:

Questi controlli vengono considerati come elementi figlio di un singolo elemento SplitButton.MenuGroups predefinito.

Esempio

Nell'esempio seguente viene illustrato il markup di base per il pulsante di divisione.

Questa sezione di codice mostra le dichiarazioni SplitButton Command, con un gruppo associato che funge da contenitore padre per l'elemento 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"/>

Questa sezione di codice mostra le dichiarazioni di controllo 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>

Informazioni sull'elemento

Sistema minimo supportato: Windows 7
Può essere vuoto: No

Vedi anche

Pulsante di divisione
SetModes

Condividi tramite