Galeria Drop-Down
A Galeria de Drop-Down consiste em um botão que, quando clicado, exibe uma lista suspensa contendo uma coleção de itens ou comandos mutuamente exclusivos.
Detalhes
Esse controle é útil para expor itens relacionados ou comandos onde não há um padrão óbvio, e os itens individuais podem ser representados por uma imagem, texto ou ambos.
O suporte para barras de garra verticais e de canto, ou alças de redimensionamento, é fornecido por meio do elementoDropDownGallery.MenuLayout.
A captura de tela a seguir ilustra a Galeria de Drop-Down da Faixa de Opções no Microsoft Paint.
Drop-Down Gallery Propriedades
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 Command associado ao controle por meio de uma chamada para o IUIFramework::InvalidateUICommand método. O evento de invalidação é manipulado e as atualizações de propriedade definidas pelo método de retorno de chamada IUICommandHandler::UpdateProperty IUICommandHandler.
O IUICommandHandler::UpdateProperty método de retorno de chamada não é executado e o aplicativo consultado para obter 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 através do método IUIFramework::GetUICommandProperty e definida com o IUIFramework::SetUICommandProperty método.
A tabela a seguir lista as chaves de propriedade associadas ao controle Galeria Drop-Down.
| Chave do imóvel | Observações |
|---|---|
| UI_PKEY_Categories | Suporta IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty. |
| UI_PKEY_Enabled | Suporta IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty. |
| UI_PKEY_ItemsSource | Suporta IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty. |
| UI_PKEY_Keytip | Só pode ser atualizado através de invalidação. |
| UI_PKEY_Label | Só pode ser atualizado através de invalidação. |
| UI_PKEY_LargeHighContrastImage | Só pode ser atualizado através de invalidação. |
| UI_PKEY_LargeImage | Só pode ser atualizado através de invalidação. |
|
UI_PKEY_SelectedItem(válido apenas para uma galeria de itens) |
Suporta 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 de sinaliza. |
| UI_PKEY_SmallHighContrastImage | Só pode ser atualizado através de invalidação. |
| UI_PKEY_SmallImage | Só pode ser atualizado através de invalidação. |
| UI_PKEY_TooltipDescription | Só pode ser atualizado através de invalidação. |
| UI_PKEY_TooltipTitle | Só pode ser atualizado através de invalidação. |