Galerie de boutons fractionnés

  • Article

La galerie de boutons fractionnés est un contrôle composite qui contient un bouton principal qui expose un seul élément par défaut ou une commande, et un bouton secondaire qui, lorsque vous cliquez dessus, affiche le reste de l’élément ou de la collection De commandes dans une liste déroulante mutuellement exclusive.

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.

capture d’écran d’un contrôle splitbuttongallery dans le ruban Microsoft Paint.

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 par un appel à la méthode IUIFramework::InvalidateUICommand . L’événement d’invalidation est géré et les mises à jour de propriété définies par la méthode de rappel IUICommandHandler::UpdateProperty .

La méthode de rappel IUICommandHandler::UpdateProperty n’est pas exécutée et l’application interrogée pour obtenir une valeur de propriété mise à jour, jusqu’à ce que la propriété soit requise par le framework. 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 Split Button Gallery.

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 Peut être mis à jour uniquement par invalidation.
UI_PKEY_Label Peut être mis à jour uniquement par invalidation.
UI_PKEY_LargeHighContrastImage Peut être mis à jour uniquement par invalidation.
UI_PKEY_LargeImage Peut être mis à jour uniquement par invalidation.
UI_PKEY_SelectedItem(valide uniquement pour une galerie d’éléments)
 Prend en charge IUIFramework::GetUICommandProperty et IUIFramework::SetUICommandProperty. Note: Si la commande associée au contrôle est invalidée par un appel à IUIFramework::InvalidateUICommand, le framework interroge cette propriété quand UI_INVALIDATIONS_VALUE est passé comme valeur d’indicateurs.
UI_PKEY_SmallHighContrastImage Peut être mis à jour uniquement par invalidation.
UI_PKEY_SmallImage Peut être mis à jour uniquement par invalidation.
UI_PKEY_TooltipDescription Peut être mis à jour uniquement par invalidation.
UI_PKEY_TooltipTitle Peut être mis à jour uniquement par invalidation.

Élément de balisage SplitButtonGallery

Utilisation des galeries

Exemple de galerie