Compartilhar via

Elemento SplitButton

  • Artigo

Representa um controle de Botão de Divisão padrão.

Uso

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

Atributos

Atributo Type Obrigatório Descrição
ApplicationModes
 xs:string
 No
 Válido somente se MenuGroup for o elemento pai.

(xs:string)
Uma cadeia de caracteres que contém uma lista separada por vírgulas de inteiros entre 0 e 31.
O espaço em branco é válido e ignorado.
Comprimento máximo: 250 caracteres.
CommandName
 xs:positiveInteger ou xs:string
 Não
 Associa o elemento a um Command.

(xs:positiveInteger ou xs:string)
Uma cadeia de caracteres, um valor inteiro entre 2 e 59999, inclusive ou um valor hexadecimal entre 0x2 e 0xea5f, inclusive.
O valor deve ser exclusivo no documento XML da Faixa de Opções.
Comprimento máximo: 100 caracteres.

Elementos filho

Elemento Descrição
Botão
 Pode ocorrer uma ou mais vezes
CheckBox
 Pode ocorrer uma ou mais vezes
DropDownButton
 Pode ocorrer uma ou mais vezes
DropDownColorPicker
 Pode ocorrer uma ou mais vezes
DropDownGallery
 Pode ocorrer uma ou mais vezes
SplitButton
 Pode ocorrer uma ou mais vezes
SplitButton.ButtonItem
 Pode ocorrer no máximo uma vez
SplitButton.MenuGroups
 Pode ocorrer no máximo uma vez
SplitButtonGallery
 Pode ocorrer uma ou mais vezes
ToggleButton
 Pode ocorrer uma ou mais vezes

Elementos pai

Elemento
ControlGroup
DropDownGallery
Grupo
Menugroup
SplitButton
SplitButtonGallery

Comentários

Opcional.

Pode ocorrer uma ou mais vezes para cada elemento ControlGroup, DropDownGallery, Group, MenuGroup, SplitButton ou SplitButtonGallery .

SplitButton dá suporte a modos de aplicativo quando ele é hospedado na coluna esquerda do Menu do Aplicativo.

DropDownGallery e SplitButtonGallery não são elementos filho válidos de DropDownButton quando DropDownButton é descendente de ApplicationMenu.

SplitButton.MenuGroups deverá ocorrer uma vez se os seguintes não estiverem presentes como elementos filho de SplitButton:

Esses controles são tratados como elementos filho de um único elemento Padrão SplitButton.MenuGroups .

Exemplos

O exemplo a seguir demonstra a marcação básica para o Botão Dividir.

Esta seção de código mostra as declarações de Comando SplitButton , com um Grupo associado que funciona como o contêiner pai para o 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"/>

Esta seção de código mostra as declarações de controle 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>

Informações do elemento

  • Sistema mínimo com suporte: Windows 7
  • Pode estar vazio: Não

Confira também

Controle Dividir Botão

SetModes