Zone de liste déroulante (Windows Ribbon Framework)

  • Article

La zone de liste modifiable se compose d’une zone de liste à colonne unique qui contient une collection d’éléments ou de commandes mutuellement exclusifs combinés à un contrôle statique ou d’édition et à une flèche déroulante. La partie zone de liste du contrôle s’affiche lorsque l’utilisateur clique sur la flèche déroulante.

Détails

L’élément ou la commande actuellement sélectionné (le cas échéant) dans la zone de liste s’affiche dans le contrôle statique ou de modification. Avec un contrôle d’édition, si l’utilisateur tape les caractères initiaux d’un élément ou d’une commande existant, la zone de liste met en surbrillance le premier élément avec ces caractères initiaux et complète automatiquement l’entrée dans le contrôle d’édition.

Prend uniquement en charge une barre de préhension verticale ou une poignée de redimensionnement.

Ce contrôle est utile pour exposer des éléments de texte simples et étroitement liés.

La capture d’écran suivante illustre la zone de liste déroulante du ruban dans Live Movie Maker.

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

Propriétés de la zone de liste déroulante

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

En règle générale, une propriété Zone de liste déroulante 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 Zone de liste déroulante.

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 Prend en charge IUIFramework::GetUICommandProperty et IUIFramework::SetUICommandProperty.
UI_PKEY_SmallHighContrastImage Peut uniquement être mis à jour via l’invalidation.
UI_PKEY_SmallImage Peut uniquement être mis à jour via l’invalidation.
UI_PKEY_StringValue 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_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 ComboBox

Utilisation des galeries

Exemple de galerie