Implémentation du modèle de contrôle Transform 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 directives à respecter pour implémenter ITransformProvider, notamment les informations sur les propriétés, les méthodes et les événements. Des liens vers des références supplémentaires sont répertoriés à la fin de la rubrique.
Le modèle de contrôle TransformPattern permet de prendre en charge des contrôles qui peuvent être déplacés, redimensionnés ou pivotés dans un espace à deux dimensions. 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 Transform, notez les conventions et recommandations suivantes :
La prise en charge pour ce modèle de contrôle ne se limite pas aux objets sur le bureau. Ce modèle de contrôle doit également être pris en charge par les enfants d’un objet conteneur si les enfants peuvent être déplacés, redimensionnés et pivotés librement dans les limites du conteneur.
Il n’est pas possible de déplacer, redimensionner ni pivoter un objet de manière à ce que son emplacement résultant à l’écran soit complètement en dehors des coordonnées de son conteneur et, par conséquent, inaccessible via le clavier et la souris (par exemple, quand une fenêtre de niveau supérieur est déplacée hors de l’écran ou qu’un objet enfant est déplacé en dehors des limites de la fenêtre d’affichage du conteneur). Dans ce cas, l’objet est placé le plus près possible des coordonnées d’écran demandées avec les coordonnées en haut et à gauche substituées de façon à être incluses dans les limites du conteneur.
Pour les systèmes à plusieurs écrans, si un objet est déplacé, redimensionné ou pivoté complètement en dehors des coordonnées d’écran du bureau combiné, l’objet est placé sur le moniteur principal, aussi près que possible des coordonnées demandées.
Tous les paramètres et valeurs de propriété sont absolus et indépendants des paramètres régionaux.
Membres requis pour ITransformProvider
Les propriétés et méthodes suivantes sont nécessaires à l'implémentation d' ITransformProvider.
| Membres nécessaires | Type de membre | Notes |
|---|---|---|
| CanMove | Propriété | Aucun |
| CanResize | Propriété | Aucun |
| CanRotate | Propriété | Aucun |
| Move | Méthode | Aucun |
| Resize | Méthode | Aucun |
| Rotate | Méthode | 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 |
|---|---|
| InvalidOperationException | Move - Si la valeur de CanMoveProperty est false. |
| InvalidOperationException | Resize - Si la valeur de CanResizeProperty est false. |
| InvalidOperationException | Rotate - Si la valeur de CanRotateProperty est false. |