Partager via

Implémentation du modèle de contrôle de transformation UI Automation

Remarque

Cette documentation est destinée 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 informations les plus récentes sur UI Automation, consultez API Windows Automation : UI Automation.

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

Le TransformPattern modèle de contrôle est utilisé pour prendre en charge les 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 qui implémentent ce modèle de contrôle, consultez Mappage des modèles de contrôle pour les clients UI Automation.

Directives et conventions de mise en œuvre

Lors de l’implémentation du modèle de contrôle Transform, notez les instructions et conventions suivantes :

  • La prise en charge de ce modèle de contrôle n’est pas limitée 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 ou pivotés librement dans les limites du conteneur.

  • Un objet ne peut pas être déplacé, redimensionné ou pivoté de telle sorte que son 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 hors é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é aussi près des coordonnées d’écran demandées que possible avec les coordonnées supérieures ou gauches remplacées pour se trouver dans les limites du conteneur.

  • Pour les systèmes multi-moniteurs, si un objet est déplacé, redimensionné ou pivoté complètement en dehors des coordonnées combinées de l’écran de bureau, l’objet est placé sur le moniteur principal aussi près des coordonnées demandées que possible.

  • Tous les paramètres et valeurs de propriété sont absolus et indépendants des paramètres régionaux.

Membres obligatoires pour ITransformProvider

Les propriétés et méthodes suivantes sont requises pour l’implémentation ITransformProvider.

Membres obligatoires 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’a aucun événement associé.

Exceptions

Les fournisseurs doivent lever les exceptions suivantes.

Type d’exception État
InvalidOperationException Move

- Si la CanMoveProperty valeur est false.
InvalidOperationException Resize

- Si la CanResizeProperty valeur est false.
InvalidOperationException Rotate

- Si la CanRotateProperty valeur est false.

Voir aussi