Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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.
Propriedades do botão Dividir
A estrutura da Faixa de Opções define uma coleção de chaves de propriedade para o controle Botão de Divisão.
Normalmente, uma propriedade Split Button é 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.
Nota
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 Botão de Divisão.
| Chave de propriedade | Anotaçõ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 Botão de Divisã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 Botão de Divisão na interface do usuário da faixa de opções. |
| UI_PKEY_Keytip | Só pode ser atualizado por invalidação. |
| UI_PKEY_TooltipDescription | Só pode ser atualizado por invalidação. |
| UI_PKEY_TooltipTitle | Só pode ser atualizado por invalidação. |