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.

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