Freigeben über


Implementieren des Transform-Steuerelementmusters der Benutzeroberflächenautomatisierung

HinweisHinweis

Diese Dokumentation ist für .NET Framework-Entwickler vorgesehen, die die verwalteten UI Automation-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind.Aktuelle Informationen zu UI Automation finden Sie unter Windows Automation API: UI Automation.

In diesem Thema werden Richtlinien und Konventionen zum Implementieren von ITransformProvider vorgestellt und Eigenschaften, Methoden sowie Ereignisse erläutert. Am Ende des Themas finden Sie Links zu zusätzlichen Verweisen.

Das TransformPattern-Steuerelementmuster dient zum Unterstützen von Steuerelementen, die zweidimensional verschoben, in der Größe geändert oder gedreht werden können. Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Zuordnen von Steuerelementmustern für Benutzeroberflächenautomatisierungs-Clients.

Dieses Thema enthält folgende Abschnitte.

  • Implementierungsrichtlinien und Konventionen
  • Erforderliche Member für ITransformProvider
  • Ausnahmen
  • Verwandte Abschnitte

Implementierungsrichtlinien und Konventionen

Beachten Sie beim Implementieren des Transform-Steuerelementmusters die folgenden Richtlinien und Konventionen:

  • Die Unterstützung für dieses Steuerelementmuster beschränkt sich nicht nur auf Objekte auf dem Desktop. Dieses Steuerelementmuster muss auch von den untergeordneten Elementen eines Containerobjekts unterstützt werden, wenn die untergeordneten Elemente innerhalb der Begrenzungen des Containers verschoben, gedreht oder in der Größe geändert werden können.

  • Ein Objekt kann nicht so verschoben, gedreht oder in der Größe geändert werden, dass sich dessen neue Bildschirmposition vollständig außerhalb der Koordinaten von dessen Container befinden und deshalb nicht mehr per Tastatur oder Maus auf das Objekt zugegriffen werden kann (zum Beispiel wenn ein Fenster der obersten Ebene aus dem Bildschirmbereich hinaus oder ein untergeordnetes Element über die Begrenzungen des Ansichtsfensters seines Containers hinweg verschoben wird). In solchen Fällen wird das Objekt so nahe wie möglich an den angeforderten Bildschirmkoordinaten platziert. Dabei werden die oberen oder linken Koordinaten so überschrieben, dass sie innerhalb der Containergrenzen liegen.

  • Wenn bei Systemen mit mehreren Bildschirmen ein Objekt so verschoben, gedreht oder in der Größe geändert wird, dass es sich vollständig außerhalb der Bildschirmkoordinaten aller Desktops befindet, wird das Objekt auf dem ersten Bildschirm so nah wie möglich an den angeforderten Koordinaten platziert.

  • Alle Parameter und Eigenschaftswerte sind absolute Angaben und unabhängig vom Gebietsschema.

Erforderliche Member für ITransformProvider

Zum Implementieren von ITransformProvider werden die folgenden Eigenschaften und Methoden benötigt.

Erforderliche Member

Membertyp

Hinweise

CanMove

Eigenschaft

Keine

CanResize

Eigenschaft

Keine

CanRotate

Eigenschaft

Keine

Move

Methode

Keine

Resize

Methode

Keine

Rotate

Methode

Keine

Dieses Steuerelementmuster verfügt über keine zugeordneten Ereignisse.

Ausnahmen

Anbieter müssen die folgenden Ausnahmen auslösen.

Ausnahmetyp

Bedingung

InvalidOperationException

Move

InvalidOperationException

Resize

InvalidOperationException

Rotate

Siehe auch

Aufgaben

Unterstützung von Steuerelementmustern in einem Benutzeroberflächenautomatisierungs-Anbieter

Verwenden der Zwischenspeicherung in der Benutzeroberflächenautomatisierung

Konzepte

Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung

Steuerelementmuster für Benutzeroberflächenautomatisierung für Clients

Übersicht über die Benutzeroberflächenautomatisierungs-Struktur