Partilhar via

Galeria de botões divididos

A Galeria de Botões Divididos é um controle composto que contém um botão primário que expõe um único item ou Comando padrão e um botão secundário que, quando clicado, exibe o restante do item ou da coleção de Comandos em uma lista suspensa mutuamente exclusiva.

Detalhes

Esse controle é útil para expor itens estreitamente relacionados nos casos em que um padrão óbvio está disponível e onde os itens individuais podem ser representados por uma imagem, texto ou ambos.

A captura de tela a seguir ilustra a Galeria de Botões de Divisão da Faixa de Opções no Microsoft Paint.

captura de tela de um controle SplitButtonGallery 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 Botões Divididos.

Normalmente, uma propriedade Split Button 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 de Botões Divididos.

Chave do imóvel Observações
UI_PKEY_BooleanValue Suporta IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty.
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.

elemento de marcação SplitButtonGallery

Trabalhar com galerias

de exemplo da Galeria

  • Last updated on