Elemento SplitButton

  • Artículo

Representa un control de botón de división estándar.

Uso

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

Atributos

Atributo Tipo Obligatorio Descripción
ApplicationModes
 xs:string
 No
 Válido solo si MenuGroup es el elemento primario.

(xs:string)
Cadena que contiene una lista separada por comas de enteros entre 0 y 31.
El espacio en blanco es válido y se omite.
Longitud máxima: 250 caracteres.
CommandName
 xs:positiveInteger o xs:string
 No
 Asocia el elemento a un objeto Command.

(xs:positiveInteger o xs:string)
Una cadena, un valor entero entre 2 y 59999, inclusive o un valor hexadecimal entre 0x2 y 0xea5f, ambos incluidos.
El valor debe ser único dentro del documento XML de la cinta de opciones.
Longitud máxima: 100 caracteres.

Elementos secundarios

Elemento Descripción
Button
 Puede producirse una o varias veces
CheckBox
 Puede producirse una o varias veces
DropDownButton
 Puede producirse una o varias veces
DropDownColorPicker
 Puede producirse una o varias veces
DropDownGallery
 Puede producirse una o varias veces
SplitButton
 Puede producirse una o varias veces
SplitButton.ButtonItem
 Puede producirse como máximo una vez
SplitButton.MenuGroups
 Puede producirse como máximo una vez
SplitButtonGallery
 Puede producirse una o varias veces
ToggleButton
 Puede producirse una o varias veces

Elementos primarios

Elemento
ControlGroup
DropDownGallery
Group (Grupo)
MenuGroup
SplitButton
SplitButtonGallery

Observaciones

Opcional.

Puede producirse una o varias veces para cada elemento ControlGroup, DropDownGallery, Group, MenuGroup, SplitButton o SplitButtonGallery .

SplitButton admite modos de aplicación cuando se hospeda en la columna izquierda del menú de la aplicación.

DropDownGallery y SplitButtonGallery no son elementos secundarios válidos de DropDownButton cuando DropDownButton es descendiente de ApplicationMenu.

SplitButton.MenuGroups debe producirse una vez si los siguientes elementos no están presentes como elementos secundarios de SplitButton:

Estos controles se tratan como elementos secundarios de un único elemento SplitButton.MenuGroups predeterminado.

Ejemplos

En el ejemplo siguiente se muestra el marcado básico para el botón dividir.

En esta sección de código se muestran las declaraciones de comando SplitButton , con un grupo asociado que funciona como contenedor primario para el 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"/>

En esta sección de código se muestran las declaraciones de control 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>

Información de elemento

  • Sistema mínimo admitido: Windows 7
  • Puede estar vacío: No

Consulte también

Control de botón de división

SetModes