Zone de liste modifiable (Windows Ribbon Framework)
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 avec un contrôle statique ou de modification 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
- propriétés de zone de liste déroulante
- rubriques connexes
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 la saisie semi-automatique de l’entrée dans le contrôle d’édition.
Prend en charge une barre de pince verticale ou une poignée de redimensionnement uniquement.
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.
Propriétés de la zone de liste modifiable
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é Combo Box 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 Zone de liste modifiable.
| 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 | 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 | Prend en charge IUIFramework ::GetUICommandProperty et IUIFramework ::SetUICommandProperty. |
| 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_StringValue | 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_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. |