Compartir a través de


Elemento SplitButtonGallery

Representa un control Split Button Gallery con un menú desplegable basado en la galería.

Uso

<SplitButtonGallery
  ApplicationModes = "xs:string"
  CommandName = "xs:positiveInteger or xs:string"
  HasLargeItems = "Boolean"
  ItemHeight = "xs:integer"
  ItemWidth = "xs:integer"
  TextPosition = "TextPositionType"
  Type = "xs:string">
  child elements
</SplitButtonGallery>

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.
HasLargeItems
Boolean
No
Determina si el recurso de imagen grande o pequeño del comando se muestra en el control galería.

Nota:
Solo se aplica a las galerías en las que el valor del atributo Type es igual a Command.


Restringido a uno de los valores siguientes (0 y 1 no son válidos):

(true)
Predeterminada.
(false)
ItemHeight
xs:integer
No
(xs:integer)
El valor predeterminado es -1.
ItemWidth
xs:integer
No
(xs:integer)
El valor predeterminado es -1.
TextPosition
TextPositionType
No
Restringido a uno de los siguientes valores:

(Abajo)
(Ocultar)
(Izquierda)
(Superposición)
(Derecha)
(Arriba)
Tipo
xs:string
No
Restringido a uno de los siguientes valores:

(Elementos)
(Comandos)

Elementos secundarios

Elemento Descripción
Botón
Puede producirse una o varias veces

Casilla
Puede producirse una o varias veces

SplitButton
Puede producirse una o varias veces

SplitButtonGallery.MenuGroups
Debe producirse exactamente una vez

SplitButtonGallery.MenuLayout
Puede producirse como máximo una vez

ToggleButton
Puede producirse una o varias veces

Elementos primarios

Elemento Descripción
ControlGroup
Group (Grupo)
MenuGroup
Cuando se encuentra en applicationMenu. Este elemento solo se admite en el primer nivel y no debe tener elementos secundarios.

QuickAccessToolbar.ApplicationDefaults
Nota:
Windows 8 y versiones posteriores.



SplitButton

Comentarios

Opcional.

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

SplitButtonGallery admite modos de aplicación.

UI_PKEY_BooleanValue usa una aplicación para consultar el estado de alternancia para el control de botón de splitButtonGallery.

En la siguiente captura de pantalla se muestra el control Galería de botones de división de la cinta de opciones en Microsoft Paint para Windows 7.

captura de pantalla de un control de galería de botones divididos en microsoft paint para Windows 7.

Ejemplos

En el ejemplo siguiente se muestra el marcado básico de la Galería de botones de división.

En esta sección de código se muestran las declaraciones splitButtonGallery Command, con un grupo asociado que funciona como contenedor primario para el elemento SplitButtonGallery .

<!-- SplitButtonGallery -->
<Command Name="cmdSplitButtonGalleryGroup"
         Symbol="cmdSplitButtonGalleryGroup"
         Comment="SplitButtonGallery Group"
         LabelTitle="SplitButtonGallery"/>
<Command Name="cmdSplitButtonGallery"
         Symbol="cmdSplitButtonGallery"
         Comment="SplitButtonGallery"
         LabelTitle="SplitButtonGallery"/>

En esta sección de código se muestran las declaraciones de control SplitButtonGallery .

<!-- SplitButtonGallery -->
<Group CommandName="cmdSplitButtonGalleryGroup">
  <SplitButtonGallery CommandName="cmdSplitButtonGallery">
    <SplitButtonGallery.MenuLayout>
      <FlowMenuLayout Rows="2"
                      Columns="3"
                      Gripper="None"/>
    </SplitButtonGallery.MenuLayout>
    <SplitButtonGallery.MenuGroups>
      <MenuGroup>
        <Button CommandName="cmdButton1"></Button>
        <Button CommandName="cmdButton2"></Button>
      </MenuGroup>
      <MenuGroup>
        <Button CommandName="cmdButton3"></Button>
      </MenuGroup>
    </SplitButtonGallery.MenuGroups>
  </SplitButtonGallery>
</Group>

Información de elemento

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

Consulte también

Control Split Button Gallery

Trabajar con galerías

SetModes

Ejemplo de galería