Share via

Groupe (Windows Ribbon Framework)

  • Article

Le groupe organise les commandes et les contrôles associés dans un onglet.

Détails

La capture d’écran suivante illustre le contrôle Groupe de ruban.

capture d’écran avec des légendes montrant un groupe.

Propriétés du groupe

L’infrastructure du ruban définit une collection de clés de propriété pour le contrôle Groupe.

En règle générale, une propriété Group est mise à jour dans l’interface utilisateur du ruban en invalidant la commande associée au contrôle via un appel à la méthode IUIFramework::InvalidateUICommand . L’événement d’invalidation est géré et la propriété est mise à jour définie par la méthode de rappel IUICommandHandler::UpdateProperty .

La méthode de rappel IUICommandHandler::UpdateProperty n’est pas exécutée et l’application a demandé une valeur de propriété mise à jour, jusqu’à ce que la propriété soit requise par l’infrastructure. Par exemple, lorsqu’un onglet est activé et qu’un contrôle est révélé dans l’interface utilisateur du ruban, ou lorsqu’une info-bulle est affichée.

Notes

Dans certains cas, une propriété peut être récupérée via la méthode IUIFramework::GetUICommandProperty et définie avec la méthode IUIFramework::SetUICommandProperty .

Le tableau suivant répertorie les clés de propriété associées au contrôle Group.

Clé de propriété Notes
UI_PKEY_Keytip Peut uniquement être mis à jour via l’invalidation. Note: L’infrastructure exige que la valeur de UI_PKEY_Keytip pour un contrôle Group commence par la lettre majuscule Z. Si la valeur fournie par l’application dans la méthode de rappel IUICommandHandler::UpdateProperty ne commence pas par la lettre Z, cette valeur est ignorée et une valeur est générée par l’infrastructure à la place. La valeur de framework est la lettre Z suivie d’une valeur numérique commençant à 1 et augmentant séquentiellement, selon les besoins, pour les contrôles Group suivants (Z1, Z2, ..., Zx).
UI_PKEY_Label Peut uniquement être mis à jour via l’invalidation.
UI_PKEY_LargeHighContrastImage Peut uniquement être mis à jour via l’invalidation.
UI_PKEY_LargeImage Peut uniquement être mis à jour via l’invalidation.
UI_PKEY_SmallHighContrastImage Peut uniquement être mis à jour via l’invalidation.
UI_PKEY_SmallImage Peut uniquement être mis à jour via l’invalidation.
UI_PKEY_TooltipDescription Peut uniquement être mis à jour via l’invalidation.
UI_PKEY_TooltipTitle Peut uniquement être mis à jour via l’invalidation.

Bibliothèque de contrôle de l’infrastructure du ruban Windows

Élément Group