Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
O Split Button é um controle composto com o qual o usuário pode selecionar um valor padrão vinculado a um botão primário ou selecionar a partir de uma lista de valores mutuamente exclusivos exibidos em uma lista suspensa vinculada a um botão secundário.
Introdução
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 o botão de divisão da faixa de opções.
Propriedades do botão de divisão
A estrutura da Faixa de Opções define uma coleção de chaves de propriedade para o controle Botão Dividido.
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 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 Split Button.
| Chave do imóvel | Observações |
|---|---|
| UI_PKEY_Enabled | Suporta 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 Split Button deve ser invalidada depois que um ou mais itens filho são habilitados ou desabilitados. Isso garante que a estrutura consulte o valor da propriedade atualizada e atualize o estado do controle Split Button na interface do usuário da faixa de opções. |
| UI_PKEY_Keytip | 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. |