Implémentation du modèle de contrôle RangeValue d’UI Automation
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.
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. |