Elemento SplitButton

Artículo
06/13/2023

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

Compartir a través de