Compartilhar via

Grupo (Estrutura da Faixa de Opções do Windows)

  • Artigo

O Grupo organiza comandos e controles relacionados em uma guia.

Detalhes

A captura de tela a seguir ilustra o controle Grupo da Faixa de Opções.

captura de tela com textos explicativos mostrando um grupo.

Propriedades do Grupo

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

Normalmente, uma propriedade Group é atualizada na interface do usuário da faixa de opções invalidando o Command 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 Group.

Chave de propriedade Observações
UI_PKEY_Keytip Só pode ser atualizado por meio de invalidação. Nota: A estrutura requer que o valor de UI_PKEY_Keytip para um controle Group comece com a letra maiúscula Z. Se o valor fornecido pelo aplicativo no método de retorno de chamada IUICommandHandler::UpdateProperty não começar com a letra Z, esse valor será ignorado e um valor será gerado pela estrutura. O valor da estrutura é a letra Z seguida por um valor numérico começando em 1 e aumentando sequencialmente, conforme necessário, para controles de grupo subsequentes (Z1, Z2, ..., Zx).
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_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.

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

Elemento Group