Compartilhar via


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.

captura de tela de um controle de caixa de combinação na faixa de opções do Microsoft Paint.

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.

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

Elemento de marcação ComboBox

Trabalhando com galerias

Exemplo de Galeria