Freigeben über

Transformieren von Steuerelementmustern

  • Artikel

Beschreibt Richtlinien und Konventionen für die Implementierung von ITransformProvider und ITransformProvider2, einschließlich Informationen zu Eigenschaften und Methoden. Das Transformationssteuerelementmuster wird verwendet, um Steuerelemente zu unterstützen, die innerhalb eines zweidimensionalen Raums verschoben, die Größe geändert oder gedreht werden können.

Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Steuerelementtypen und deren unterstützte Steuerelementmuster.

Dieses Thema enthält folgende Abschnitte:

Implementierungsrichtlinien und -konventionen

Beachten Sie beim Implementieren des Transformationssteuerelementmusters 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 verschoben, vergrößert, verkleinert oder innerhalb der Grenzen des Containers frei gedreht werden können.
  • Ein Objekt kann nicht so verschoben, vergrößert, verkleinert oder gedreht werden, dass seine resultierende Bildschirmposition vollständig außerhalb der Koordinaten des Containers liegt und daher nicht über die Tastatur oder Maus zugänglich ist (wenn z. B. ein Fenster auf oberster Ebene außerhalb des Bildschirms oder ein untergeordnetes Objekt außerhalb der Viewportgrenzen des Containers verschoben wird). In diesen Fällen wird das Objekt so nahe wie möglich bei den angeforderten Bildschirmkoordinaten platziert, wobei die oberen oder linken Koordinaten außer Kraft gesetzt werden, damit sich die Koordinaten innerhalb der Containergrenzen befinden.
  • Für Systeme mit mehreren Monitoren wird ein Objekt so nahe wie möglich bei den angeforderten Koordinaten auf dem primären Monitor platziert, wenn das Objekt vollständig außerhalb der Bildschirmkoordinaten des kombinierten Desktops verschoben, vergrößert, verkleinert oder gedreht wird.
  • Alle Parameter und Eigenschaftswerte sind absolute Angaben und unabhängig vom Gebietsschema.

Erforderliche Elemente für ITransformProvider

Die folgenden Eigenschaften und Methoden sind für die Implementierung der ITransformProvider-Schnittstelle erforderlich.

Erforderliche Member Memberart Hinweise
CanMove Eigenschaft Keine
CanResize Eigenschaft Keine
CanRotate Eigenschaft Keine
Verschieben Methode Keine
Größe ändern Methode Keine
Drehen Methode Keine

 

Die folgenden zusätzlichen Eigenschaften und Methoden sind für die Implementierung der ITransformProvider2-Schnittstelle erforderlich.

Erforderliche Member Memberart Hinweise
CanZoom Eigenschaft Keine
Zoom Methode Keine
ZoomByUnit Methode Keine
ZoomLevel Eigenschaft Keine
ZoomMaximum Eigenschaft Keine
ZoomMinimum Eigenschaft Keine

 

Diesem Steuerelementmuster sind keine Ereignisse zugeordnet.

Steuerelementtypen und deren unterstützte Steuerelementmuster

Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierungs-Struktur