Caixa de combinação (Estrutura da Faixa de Opções do Windows)
A Caixa de Combinação consiste em uma caixa de listagem de coluna única que contém uma coleção de itens mutuamente exclusivos ou Comandos combinados com um controle estático ou de edição e uma seta suspensa. A parte da caixa de listagem do controle é exibida quando o usuário clica na seta suspensa.
Detalhes
O item selecionado no momento ou Comando (se houver) na caixa de listagem é exibido no controle estático ou de edição. Com um controle de edição, se o usuário digitar os caracteres iniciais de um item ou Comando existente, a caixa de listagem realçará o primeiro item com esses caracteres iniciais e preencherá automaticamente a entrada no controle de edição.
Dá suporte apenas a uma barra de garra vertical ou alça de redimensionamento.
Esse controle é útil para expor itens de texto simples e intimamente relacionados.
A captura de tela a seguir ilustra a Caixa de Combinação da Faixa de Opções no Live Movie Maker.
Propriedades da caixa de combinação
A estrutura da Faixa de Opções define uma coleção de chaves de propriedade para o controle Caixa de Combinação.
Normalmente, uma propriedade Caixa de Combinação é 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 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 Caixa de Combinação.
| Chave de propriedade | Observações |
|---|---|
| UI_PKEY_Categories | Dá suporte a IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty. |
| UI_PKEY_Enabled | Dá suporte a IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty. |
| UI_PKEY_ItemsSource | Dá suporte a IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty. |
| UI_PKEY_Keytip | Só pode ser atualizado por meio de invalidação. |
| UI_PKEY_Label | Só pode ser atualizado por meio de invalidação. |
| UI_PKEY_LargeHighContrastImage | Só pode ser atualizado por meio de invalidação. |
| UI_PKEY_LargeImage | Só pode ser atualizado por meio de invalidação. |
| UI_PKEY_SelectedItem | Dá suporte a IUIFramework::GetUICommandProperty e IUIFramework::SetUICommandProperty. |
| UI_PKEY_SmallHighContrastImage | Só pode ser atualizado por meio de invalidação. |
| UI_PKEY_SmallImage | Só pode ser atualizado por meio de invalidação. |
| UI_PKEY_StringValue | Dá suporte a 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 dos sinalizadores. |
| UI_PKEY_TooltipDescription | Só pode ser atualizado por meio de invalidação. |
| UI_PKEY_TooltipTitle | Só pode ser atualizado por meio de invalidação. |