Botão Drop-Down
O botão Drop-Down consiste em um botão que, quando clicado, exibe uma lista suspensa de itens mutuamente exclusivos.
Detalhes
Esse controle é útil para expor itens intimamente relacionados em casos em que nenhum 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 Drop-Down da Faixa de Opções em uma faixa de opções de exemplo.
Propriedades do botão Drop-Down
A estrutura da Faixa de Opções define uma coleção de chaves de propriedade para o controle botão Drop-Down.
Normalmente, uma propriedade Drop-Down 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 Drop-Down.
| Chave de propriedade | Anotações |
|---|---|
| UI_PKEY_Categories | Dá suporte a IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty. |
| 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 do controle Drop-Down Button 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 Drop-Down na interface do usuário da faixa de opções. |
| UI_PKEY_ItemsSource | Dá suporte a IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty. |
| UI_PKEY_Keytip | Só pode ser atualizado por invalidação. |
| UI_PKEY_Label | Só pode ser atualizado por invalidação. |
| UI_PKEY_LargeHighContrastImage | Só pode ser atualizado por invalidação. |
| UI_PKEY_LargeImage | Só pode ser atualizado por invalidação. |
| UI_PKEY_SelectedItem | Dá suporte a IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty.
Observação: 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 dos sinalizadores . |
| UI_PKEY_SmallHighContrastImage | Só pode ser atualizado por invalidação. |
| UI_PKEY_SmallImage | 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. |