Caixa de seleção

A Caixa de Seleção é um controle que o usuário pode clicar para fornecer entrada a um aplicativo. O controle fornece um estado de alternância representado visualmente.

• Detalhes
• Propriedades da Caixa de Seleção
• Tópicos relacionados

Detalhes

A Caixa de Seleção não dá suporte a um estado terciário ou indeterminado.

A captura de tela a seguir ilustra o elemento Caixa de Seleção da Faixa de Opções.

Propriedades da Caixa de Seleção

A estrutura da Faixa de Opções define uma coleção de chaves de propriedade para o controle Caixa de Seleção.

Normalmente, uma propriedade Check Box é 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.

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 Seleção.

Chave de Propriedade	Observações
UI_PKEY_BooleanValue	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_Enabled	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_LabelDescription	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_SmallHighContrastImage	Só pode ser atualizado por meio de invalidação.
UI_PKEY_SmallImage	Só pode ser atualizado por meio de invalidação.
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 CheckBox