Implémentation du modèle de contrôle RangeValue d’UI Automation

  • Article

Notes

Cette documentation s’adresse aux développeurs .NET Framework qui souhaitent utiliser les classes UI Automation managées définies dans l’espace de noms System.Windows.Automation. Pour obtenir les dernières informations sur UI Automation, consultez API Windows Automation : UI Automation.

Cette rubrique présente les conventions et recommandations à respecter pour implémenter IRangeValueProvider, notamment des informations sur les événements et les propriétés. Des liens vers des références supplémentaires sont répertoriés à la fin de la rubrique.

Le modèle de contrôle RangeValuePattern est utilisé pour prendre en charge les contrôles auxquels vous pouvez affecter une valeur comprise dans une plage. Pour obtenir des exemples de contrôles implémentant ce modèle de contrôle, consultez Control Pattern Mapping for UI Automation Clients.

Conventions et directives d'implémentation

Quand vous implémentez le modèle de contrôle RangeValue, notez les conventions et recommandations suivantes :

  • Les contrôles autorisent le réétalonnage de leurs propriétés prises en charge en fonction des paramètres régionaux ou des préférences de l’utilisateur. Par exemple, vous pouvez définir un contrôle de thermomètre pour afficher la température en degrés Fahrenheit ou Celsius.

  • Les contrôles qui ont des valeurs de plage ambiguës, telles que les barres de progression ou les curseurs, doivent normaliser ces valeurs.

Progress bar. Exemple d’une barre de progression où la valeur est de type entier, et où les valeurs de propriété minimale et maximale sont normalisées à 0 et 100, respectivement

Membres obligatoires pour IRangeValueProvider

Membre obligatoire Type de membre Notes
IsReadOnlyProperty Propriété Aucun
ValueProperty Propriété Aucun
LargeChangeProperty Propriété Aucun
SmallChangeProperty Propriété Aucun
MaximumProperty Propriété Aucun
MinimumProperty Propriété Aucun
SetValue Méthodes Aucun

Ce modèle de contrôle n’est associé aucun événement.

Exceptions

Les fournisseurs doivent lever les exceptions suivantes.

Type d'exception Condition
ArgumentOutOfRangeException SetValue est appelé avec une valeur supérieure à MaximumProperty , ou inférieure à MinimumProperty.

Voir aussi