bouton Drop-Down
Le bouton Drop-Down se compose d’un bouton qui, lorsqu’on clique dessus, 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 bouton Drop-Down ruban dans un exemple de ruban.
Propriétés du bouton Drop-Down
L’infrastructure du ruban définit une collection de clés de propriété pour le contrôle Button Drop-Down.
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 par un appel à la méthode IUIFramework::InvalidateUICommand . L’événement d’invalidation est géré et les mises à jour de propriété définies par la méthode de rappel IUICommandHandler::UpdateProperty .
La méthode de rappel IUICommandHandler::UpdateProperty n’est pas exécutée et l’application interrogée pour obtenir une valeur de propriété mise à jour, jusqu’à ce que la propriété soit requise par le framework. 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 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 pour le 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 | Peut être mis à jour uniquement par invalidation. |
| UI_PKEY_Label | Peut être mis à jour uniquement par invalidation. |
| UI_PKEY_LargeHighContrastImage | Peut être mis à jour uniquement par invalidation. |
| UI_PKEY_LargeImage | Peut être mis à jour uniquement par invalidation. |
| UI_PKEY_SelectedItem | 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, le framework interroge cette propriété quand UI_INVALIDATIONS_VALUE est passé comme valeur d’indicateurs. |
| UI_PKEY_SmallHighContrastImage | Peut être mis à jour uniquement par invalidation. |
| UI_PKEY_SmallImage | Peut être mis à jour uniquement par invalidation. |
| UI_PKEY_TooltipDescription | Peut être mis à jour uniquement par invalidation. |
| UI_PKEY_TooltipTitle | Peut être mis à jour uniquement par invalidation. |