Elemento DropDownGallery

Representa un control Galería desplegable con un menú basado en la galería.

Uso

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

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, ambos incluidos, o un valor hexadecimal entre 0x2 y 0xea5f, ambos incluidos.
El valor debe ser único en el 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 de 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 valores siguientes:

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

(Elementos)
(Comandos)

Elementos secundarios

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

Casilla
Puede producirse una o varias veces

DropDownGallery.MenuGroups
Debe producirse exactamente una vez

DropDownGallery.MenuLayout
Puede producirse como máximo una vez

SplitButton
Puede producirse una o varias veces

ToggleButton
Puede producirse una o varias veces

Elementos primarios

Elemento Descripción
ControlGroup
Group (Grupo)
MenuGroup
Cuando se encuentra en un 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, DropDownButton, Group, MenuGroup o SplitButton .

DropDownGallery admite modos de aplicación.

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

captura de pantalla de un control de galería desplegable en Microsoft Paint para Windows 7.

Ejemplos

En el ejemplo siguiente se muestra el marcado básico de DropDownGallery.

En esta sección de código se muestran las declaraciones DropDownGallery Command, con un grupo asociado que actúa como contenedor primario para el elemento DropDownGallery .

<!-- DropDownGallery -->
<Command Name="cmdDropDownGalleryGroup"
         Symbol="cmdDropDownGalleryGroup"
         Comment="DropDownGallery Group"
         LabelTitle="DropDownGallery"/>
<Command Name="cmdDropDownGallery"
         Symbol="cmdDropDownGallery"
         Comment="DropDownGallery"
         LabelTitle="DropDownGallery"/>

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

<!-- DropDownGallery -->
<Group CommandName="cmdDropDownGalleryGroup">
  <DropDownGallery CommandName="cmdDropDownGallery"
                   TextPosition="Hide"
                   Type="Commands"
                   ItemHeight="32"
                   ItemWidth="32">
    <DropDownGallery.MenuLayout>
      <FlowMenuLayout Rows="2"
                      Columns="3"
                      Gripper="None"/>
    </DropDownGallery.MenuLayout>
    <DropDownGallery.MenuGroups>
      <MenuGroup>
        <Button CommandName="cmdButton1"></Button>
        <Button CommandName="cmdButton2"></Button>
       </MenuGroup>
       <MenuGroup>
        <Button CommandName="cmdButton3"></Button>
      </MenuGroup>
    </DropDownGallery.MenuGroups>
  </DropDownGallery>
</Group>

Información de elemento

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

Consulte también

Control galería desplegable

Trabajar con galerías

SetModes

Ejemplo de galería