Grupo (Windows Ribbon Framework)
O Grupo organiza Comandos e controles relacionados dentro de um de Guia.
Detalhes
A captura de tela a seguir ilustra o controle Grupo da Faixa de Opções.
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 IUIFramework::InvalidateUICommand. O evento de invalidação é manipulado e as atualizações de propriedade definidas pelo método de retorno de chamada IUICommandHandler::UpdateProperty IUICommandHandler.
O IUICommandHandler::UpdateProperty método de retorno de chamada não é executado e o aplicativo consultado para obter 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 através do método IUIFramework::GetUICommandProperty e definida com o IUIFramework::SetUICommandProperty método.
A tabela a seguir lista as chaves de propriedade associadas ao controle Group.
| Chave do imóvel | Observações |
|---|---|
| UI_PKEY_Keytip | Só pode ser atualizado através de invalidação.
Nota: A estrutura requer que o valor de UI_PKEY_Keytip para um controle de grupo comece com a letra maiúscula Z. Se o valor fornecido pelo aplicativo no IUICommandHandler::UpdateProperty método de retorno de chamada 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 através de invalidação. |
| UI_PKEY_LargeHighContrastImage | Só pode ser atualizado através de invalidação. |
| UI_PKEY_LargeImage | Só pode ser atualizado através de invalidação. |
| UI_PKEY_SmallHighContrastImage | Só pode ser atualizado através de invalidação. |
| UI_PKEY_SmallImage | Só pode ser atualizado através de invalidação. |
| UI_PKEY_TooltipDescription | Só pode ser atualizado através de invalidação. |
| UI_PKEY_TooltipTitle | Só pode ser atualizado através de invalidação. |