Compartilhar via


Botão (Estrutura da Faixa de Opções do Windows)

O Botão é um controle que o usuário pode clicar para fornecer entrada a um aplicativo.

  • introdução
  • Propriedades do botão
  • tópicos relacionados

Introdução

A captura de tela a seguir contém três exemplos do elemento Botão da Faixa de Opções.

captura de tela de controles de botão na faixa de opções do microsoft wordpad.

Propriedades do botão

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

Normalmente, uma propriedade 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 Button.

Chave de propriedade Anotações
UI_PKEY_Enabled 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_LabelDescription 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_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.

 

biblioteca de controle da Estrutura da Faixa de Opções do Windows

elemento de marcação Button