Compartilhar via


Galeria Drop-Down

A Galeria de Drop-Down consiste em um botão que, quando clicado, exibe uma lista suspensa que contém uma coleção de itens mutuamente exclusivos ou Comandos.

Detalhes

Esse controle é útil para expor itens relacionados ou Comandos em que não há nenhum padrão óbvio e os itens individuais podem ser representados por uma imagem, texto ou ambos.

O suporte para barras de garras verticais e de canto ou alças de redimensionamento é fornecido por meio do elemento DropDownGallery.MenuLayout .

A captura de tela a seguir ilustra a Galeria de Drop-Down da Faixa de Opções no Microsoft Paint.

captura de tela de um controle dropdowngallery na faixa de opções do Microsoft Paint.

A estrutura da Faixa de Opções define uma coleção de chaves de propriedade para o controle galeria de Drop-Down.

Normalmente, uma propriedade Drop-Down Gallery é atualizada na interface do usuário da faixa de opções invalidando o Comando associado ao controle por meio de uma chamada para o método IUIFramework::InvalidateUICommand . O evento de invalidação é tratado e as atualizações de propriedade definidas pelo método de retorno de chamada IUICommandHandler::UpdateProperty .

O método de retorno de chamada IUICommandHandler::UpdateProperty não é executado e o aplicativo consultou um valor de propriedade atualizado até que a propriedade seja exigida pela estrutura. Por exemplo, quando uma guia é ativada e um controle revelado na interface do usuário da faixa de opções ou quando uma dica de ferramenta é exibida.

Observação

Em alguns casos, uma propriedade pode ser recuperada por meio do método IUIFramework::GetUICommandProperty e definida com o método IUIFramework::SetUICommandProperty .

A tabela a seguir lista as chaves de propriedade associadas ao controle galeria de Drop-Down.

Chave de Propriedade Observações
UI_PKEY_Categories Dá suporte a IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty.
UI_PKEY_Enabled Dá suporte a IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty.
UI_PKEY_ItemsSource Dá suporte a IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty.
UI_PKEY_Keytip Só pode ser atualizado por meio de invalidação.
UI_PKEY_Label Só pode ser atualizado por meio de invalidação.
UI_PKEY_LargeHighContrastImage Só pode ser atualizado por meio de invalidação.
UI_PKEY_LargeImage Só pode ser atualizado por meio de invalidação.
UI_PKEY_SelectedItem (válido apenas para uma galeria de itens)
Dá suporte a IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty. Nota: Se o Comando associado ao controle for invalidado por meio de uma chamada para IUIFramework::InvalidateUICommand, a estrutura consultará essa propriedade quando UI_INVALIDATIONS_VALUE for passada como o valor dos sinalizadores.
UI_PKEY_SmallHighContrastImage Só pode ser atualizado por meio de invalidação.
UI_PKEY_SmallImage Só pode ser atualizado por meio de invalidação.
UI_PKEY_TooltipDescription Só pode ser atualizado por meio de invalidação.
UI_PKEY_TooltipTitle Só pode ser atualizado por meio de invalidação.

Biblioteca de Controle da Estrutura da Faixa de Opções do Windows

Elemento de marcação DropDownGallery

Trabalhando com galerias

Exemplo de galeria