Implementieren des Transform-Steuerelementmusters der Benutzeroberflächenautomatisierung

Artikel
08/10/2011

Hinweis
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 Wenn CanMoveProperty auf "false" festgelegt ist.
InvalidOperationException	Resize Wenn CanResizeProperty auf "false" festgelegt ist.
InvalidOperationException	Rotate Wenn CanRotateProperty auf "false" festgelegt ist.

InvalidOperationException

Move