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
• Propriedades da caixa de combinação
• Tópicos relacionados

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.

Tópicos relacionados

Biblioteca de Controle da Estrutura da Faixa de Opções do Windows

Elemento de marcação ComboBox

Trabalhando com galerias

Exemplo de Galeria