Partager via


galerie Drop-Down

La galerie de Drop-Down se compose d’un bouton qui, lorsqu’il est cliqué, affiche une liste déroulante contenant une collection d’éléments ou de commandes mutuellement exclusifs.

Détails

Ce contrôle est utile pour exposer des éléments ou des commandes associés lorsqu’il n’existe pas de valeur par défaut évidente et que les éléments individuels peuvent être représentés par une image, un texte ou les deux.

La prise en charge des barres de préhension verticales et d’angle, ou des poignées de redimensionnement, est fournie via l’élément DropDownGallery.MenuLayout .

La capture d’écran suivante illustre le ruban Drop-Down Galerie dans Microsoft Paint.

capture d’écran d’un contrôle de liste déroulantegallery dans le ruban Microsoft Paint.

L’infrastructure ruban définit une collection de clés de propriété pour le contrôle galerie Drop-Down.

En règle générale, une propriété galerie Drop-Down 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 galerie Drop-Down.

Clé de propriété Notes
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 uniquement être mis à jour via l’invalidation.
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_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, l’infrastructure interroge cette propriété quand UI_INVALIDATIONS_VALUE est passée comme valeur d’indicateurs.
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 de balisage DropDownGallery

Utilisation des galeries

Exemple de galerie