Freigeben über

Implementieren des Transform-Steuerelementmusters der Benutzeroberflächenautomatisierung

Hinweis

Diese Dokumentation richtet sich an .NET Framework-Entwickler, die die verwalteten Benutzeroberflächenautomatisierungs-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind. Die neuesten Informationen zur Benutzeroberflächenautomatisierung finden Sie unter Windows Automation API: Benutzeroberflächenautomatisierung.

In diesem Thema werden Richtlinien und Konventionen für die Implementierung von ITransformProvidervorgestellt, einschließlich Informationen zu Eigenschaften, Methoden und Ereignissen. Links zu zusätzlichen Referenzen sind am Ende dieses Themas aufgelistet.

Das TransformPattern Steuerelementmuster wird verwendet, um Steuerelemente zu unterstützen, die innerhalb eines zweidimensionalen Raums verschoben, verkleinert oder gedreht werden können. Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Steuerelementmusterzuordnung für Benutzeroberflächenautomatisierungs-Clients.

Implementierungsrichtlinien und -konventionen

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

  • Die Unterstützung für dieses Steuerelementmuster ist nicht auf Objekte auf dem Desktop beschränkt. Dieses Steuerelementmuster muss auch von den untergeordneten Elementen eines Containerobjekts unterstützt werden, wenn die untergeordneten Elemente innerhalb der Grenzen des Containers verschoben, verkleinert oder gedreht werden können.

  • Ein Objekt kann nicht verschoben, verkleinert oder gedreht werden, sodass die resultierende Bildschirmposition vollständig außerhalb der Koordinaten des Containers liegt und daher nicht auf die Tastatur oder Maus zugegriffen werden kann (z. B. wenn ein Fenster der obersten Ebene außerhalb des Bildschirms verschoben wird oder ein untergeordnetes Objekt außerhalb der Grenzen des Viewports des Containers verschoben wird). In diesen Fällen wird das Objekt so nah an den angeforderten Bildschirmkoordinaten wie möglich platziert, wobei die oberen oder linken Koordinaten überschrieben werden, um sich innerhalb der Containergrenzen zu befinden.

  • Wenn ein Objekt bei Systemen mit mehreren Monitoren verschoben, verkleinert oder vollständig außerhalb der kombinierten Desktopbildschirmkoordinaten gedreht wird, wird das Objekt so nah wie möglich auf dem primären Monitor platziert.

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

Erforderliche Mitglieder für ITransformProvider

Die folgenden Eigenschaften und Methoden sind für das Implementieren von ITransformProvidererforderlich.

Erforderliche Mitglieder Memberart Hinweise
CanMove Eigentum Nichts
CanResize Eigentum Nichts
CanRotate Eigentum Nichts
Move Methode Nichts
Resize Methode Nichts
Rotate Methode Nichts

Diesem Steuerelementmuster sind keine Ereignisse zugeordnet.

Ausnahmen

Anbieter müssen die folgenden Ausnahmen auslösen.

Ausnahmetyp Zustand
InvalidOperationException Move

- Wenn der CanMoveProperty Wert "false" ist.
InvalidOperationException Resize

- Wenn der CanResizeProperty Wert "false" ist.
InvalidOperationException Rotate

- Wenn der CanRotateProperty Wert "false" ist.

Siehe auch

  • Last updated on