Partager via

bouton Drop-Down

Le bouton Drop-Down se compose d’un bouton qui, lorsque vous cliquez sur, affiche une liste déroulante d’éléments mutuellement exclusifs.

Détails

Ce contrôle est utile pour exposer des éléments étroitement liés dans les cas où aucune valeur par défaut évidente n’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 le ruban Drop-Down Bouton dans un exemple de ruban.

capture d’écran d’un contrôle dropdownbutton dans un exemple de ruban.

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

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

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.
Si tous les éléments enfants sont désactivés, l’infrastructure définit UI_PKEY_Enabled sur false (0). Sinon, si un ou plusieurs éléments enfants sont activés, UI_PKEY_Enabled a la valeur true (-1). Important :
La propriété UI_PKEY_Enabled du contrôle Drop-Down Button doit être invalidée une fois qu’un ou plusieurs éléments enfants sont activés ou désactivés. Cela garantit que l’infrastructure interroge la valeur de propriété mise à jour et actualise l’état du contrôle Drop-Down Button dans l’interface utilisateur du ruban.
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. 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_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_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.

bibliothèque de contrôle d’infrastructure du ruban Windows

élément de balisage DropDownButton

  • Last updated on