Galerie de boutons fractionnés
La galerie de boutons fractionnés est un contrôle composite qui contient un bouton principal qui expose un élément ou une commande par défaut unique, et un bouton secondaire qui, lorsque vous cliquez sur, affiche le reste de l’élément ou de la collection Command dans une liste déroulante mutuellement exclusive.
- Détails
- propriétés de la galerie de boutons fractionnés
- rubriques connexes
Détails
Ce contrôle est utile pour exposer des éléments étroitement liés dans les cas où une valeur par défaut évidente est disponible et où les éléments individuels peuvent être représentés par une image, un texte ou les deux.
La capture d’écran suivante illustre la galerie de boutons fractionnés du ruban dans Microsoft Paint.
Propriétés de la galerie de boutons fractionnés
L’infrastructure du ruban définit une collection de clés de propriété pour le contrôle Galerie de boutons fractionnés.
En règle générale, une propriété Split Button Gallery 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 les mises à jour de propriétés définies par l'IUICommandHandler ::UpdateProperty méthode de rappel.
La méthode de rappel IUICommandHandler ::UpdateProperty n’est pas exécutée et l’application interrogée pour 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.
Note
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 Galerie de boutons fractionnés.
| Clé de propriété | Notes |
|---|---|
| UI_PKEY_BooleanValue | Prend en charge IUIFramework ::GetUICommandProperty et IUIFramework ::SetUICommandProperty. |
| UI_PKEY_Categories | Prend en charge IUIFramework ::GetUICommandProperty et IUIFramework ::SetUICommandProperty. |
| UI_PKEY_Enabled | Prend en charge IUIFramework ::GetUICommandProperty et IUIFramework ::SetUICommandProperty. |
| UI_PKEY_ItemsSource | Prend en charge IUIFramework ::GetUICommandProperty et IUIFramework ::SetUICommandProperty. |
| UI_PKEY_Keytip | Ne peut être mis à jour qu’à l’aide d’une invalidation. |
| UI_PKEY_Label | Ne peut être mis à jour qu’à l’aide d’une invalidation. |
| UI_PKEY_LargeHighContrastImage | Ne peut être mis à jour qu’à l’aide d’une invalidation. |
| UI_PKEY_LargeImage | Ne peut être mis à jour qu’à l’aide d’une invalidation. |
|
UI_PKEY_SelectedItem(valide uniquement pour une galerie d’éléments) |
Prend en charge IUIFramework ::GetUICommandProperty et IUIFramework ::SetUICommandProperty.
Remarque : Si la commande associée au contrôle est invalidée par le biais d’un appel à IUIFramework ::InvalidateUICommand, l’infrastructure interroge cette propriété lorsque UI_INVALIDATIONS_VALUE est passée en tant que valeur de indicateurs. |
| UI_PKEY_SmallHighContrastImage | Ne peut être mis à jour qu’à l’aide d’une invalidation. |
| UI_PKEY_SmallImage | Ne peut être mis à jour qu’à l’aide d’une invalidation. |
| UI_PKEY_TooltipDescription | Ne peut être mis à jour qu’à l’aide d’une invalidation. |
| UI_PKEY_TooltipTitle | Ne peut être mis à jour qu’à l’aide d’une invalidation. |