Botão de Divisão

  • Artigo

O Botão dividir é um controle composto com o qual o usuário pode selecionar um valor padrão associado a um botão primário ou selecionar em uma lista de valores mutuamente exclusivos exibidos em uma lista suspensa associada a um botão secundário.

Introdução

Esse controle é útil para expor itens intimamente relacionados em 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 o Botão de Divisão da Faixa de Opções.

captura de tela de um controle splitbutton em uma faixa de opções de exemplo.

Propriedades do botão Dividir

A estrutura da Faixa de Opções define uma coleção de chaves de propriedade para o controle Dividir Botão.

Normalmente, uma propriedade Split Button é atualizada na interface do usuário da faixa de opções invalidando o Command 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 consulta 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 Dividir Botão.

Chave de propriedade Observações
UI_PKEY_Enabled Dá suporte a IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty.
Se todos os itens filho estiverem desabilitados, a estrutura definirá UI_PKEY_Enabled como false (0). Caso contrário, se um ou mais itens filho estiverem habilitados, UI_PKEY_Enabled será definido como true (-1). Importante:
A propriedade UI_PKEY_Enabled para o controle Dividir Botão deve ser invalidada depois que um ou mais itens filho estiverem habilitados ou desabilitados. Isso garante que a estrutura consulte o valor da propriedade atualizada e atualize o estado do controle Dividir Botão na interface do usuário da faixa de opções.
UI_PKEY_Keytip 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 SplitButton