Implémentation du modèle de contrôle Transform d'UI Automation

Article
08/10/2011

Remarque
Cette documentation s'adresse aux développeurs .NET Framework qui veulent utiliser les classes UI Automation managées définies dans l'espace de noms System.Windows.Automation.Pour obtenir les informations les plus récentes sur UI Automation, consultez API Windows Automation : UI Automation (page éventuellement en anglais).

Cette rubrique présente les conventions et instructions pour l'implémentation de ITransformProvider, y compris des informations sur les propriétés, les méthodes et les événements. Des liens vers des références supplémentaires sont référencés à la fin de la rubrique.

Le modèle de contrôle TransformPattern est utilisé pour prendre en charge les contrôles qui peuvent être déplacés, redimensionnés ou pivotés dans un espace en deux dimensions. Pour obtenir des exemples de contrôles qui implémentent ce modèle de contrôle, consultez Mappage de modèle de contrôle pour les clients UI Automation.

Cette rubrique comprend les sections suivantes.

Conventions et instructions de l'implémentation
Membres requis pour ITransformProvider
Exceptions
Rubriques connexes

Conventions et instructions de l'implémentation

Lorsque vous implémentez le modèle de contrôle Transform, notez les conventions et instructions suivantes :

La prise en charge de ce modèle de contrôle n'est pas limitée aux objets du 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 ou pivotés librement dans les limites du conteneur.
Un objet ne peut pas être déplacé, redimensionné ou pivoté de sorte que l'emplacement d'écran résultant soit complètement en dehors des coordonnées de son conteneur et, par conséquent, inaccessible au clavier ou à la souris (par exemple, lorsqu'une fenêtre de niveau supérieur est déplacée en dehors de l'écran ou qu'un objet enfant est déplacé en dehors des limites de la fenêtre d'affichage du conteneur). Dans ces cas, l'objet est placé le plus près possible des coordonnées d'écran demandées et les coordonnées haut et gauche sont substituées pour être incluses dans les limites du conteneur.
Pour les systèmes à écrans multiples, si un objet est déplacé, redimensionné ou pivoté complètement en dehors des coordonnées d'écran combinées du bureau, l'objet est placé sur l'écran principal, le plus près 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 de ITransformProvider.

Membres requis	Type de membre	Remarques
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 CanMoveProperty a la valeur false.
InvalidOperationException	Resize Si CanResizeProperty a la valeur false.
InvalidOperationException	Rotate Si CanRotateProperty a la valeur false.

InvalidOperationException

Move