Elemento DropDownGallery

Representa um controle da Galeria Suspensa com um menu baseado em galeria.

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	Obrigatório	Descrição
ApplicationModes	xs:string	Não	Válido somente se MenuGroup for o elemento pai. (xs:string) Uma cadeia de caracteres que contém uma lista separada por vírgulas de inteiros entre 0 e 31. O espaço em branco é válido e ignorado. Comprimento máximo: 250 caracteres.
CommandName	xs:positiveInteger ou xs:string	Não	Associa o elemento a um Command. (xs:positiveInteger ou xs:string) Uma cadeia de caracteres, um valor inteiro entre 2 e 59999, inclusive ou um valor hexadecimal entre 0x2 e 0xea5f, inclusive. O valor deve ser exclusivo no documento XML da Faixa de Opções. Comprimento máximo: 100 caracteres.
HasLargeItems	Boolean	Não	Determina se o recurso de imagem grande ou pequena do Comando é exibido no controle da galeria. Observação: Aplica-se somente a galerias em que o valor do atributo Type é igual a Command. Restrito a um dos seguintes valores (0 e 1 não são válidos): (true) Padrão. (false)
Itemheight	xs:integer	Não	(xs:integer) O padrão é -1.
Itemwidth	xs:integer	Não	(xs:integer) O padrão é -1.
TextPosition	TextPositionType	Não	Restrito a um dos seguintes valores: (Inferior) (Ocultar) (Esquerda) (Sobreposição) (À direita) (Superior)
Tipo	xs:string	Não	Restrito a um dos seguintes valores: (Itens) (Comandos)

Elementos filho

Elemento	Descrição
Botão	Pode ocorrer uma ou mais vezes
Checkbox	Pode ocorrer uma ou mais vezes
DropDownGallery.MenuGroups	Deve ocorrer exatamente uma vez
DropDownGallery.MenuLayout	Pode ocorrer no máximo uma vez
SplitButton	Pode ocorrer uma ou mais vezes
ToggleButton	Pode ocorrer uma ou mais vezes

Elementos pai

Elemento	Descrição
ControlGroup
Grupo
Menugroup	Quando contido em um ApplicationMenu. Esse elemento só tem suporte no primeiro nível e não deve ter elementos filho.
QuickAccessToolbar.ApplicationDefaults	Observação: Windows 8 e mais recente.
SplitButton

Comentários

Opcional.

Pode ocorrer uma ou mais vezes para cada elemento ControlGroup, DropDownButton, Group, MenuGroup ou SplitButton .

DropDownGallery dá suporte a modos de aplicativo.

A captura de tela a seguir ilustra o controle Galeria Suspensa da Faixa de Opções no Microsoft Paint para Windows 7.

Exemplos

O exemplo a seguir demonstra a marcação básica para o DropDownGallery.

Esta seção de código mostra as declarações do Comando DropDownGallery , com um Grupo associado que atua como o contêiner pai para o elemento DropDownGallery .

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

Esta seção de código mostra as declarações de controle 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>

Informações do elemento

• Sistema mínimo com suporte: Windows 7
• Pode estar vazio: Não

Confira também

Controle da Galeria Suspensa

Trabalhando com galerias

SetModes

Exemplo de Galeria