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.
Propriétés de la galerie Drop-Down
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. |