Implementieren des Window-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 IWindowProvider vorgestellt und WindowPattern-Eigenschaften, -Methoden und -Ereignisse erläutert. Am Ende des Themas finden Sie Links zu zusätzlichen Verweisen.

Das WindowPattern-Steuerelementmuster dient der Unterstützung von Steuerelementen, die grundlegende Windows-Funktionen innerhalb einer herkömmlichen graphical user interface (GUI) bereitstellen. Zu Steuerelementen, die dieses Steuerelementmuster implementieren müssen, gehören zum Beispiel Anwendungsfenster der obersten Ebene, untergeordnete multiple-document interface (MDI)-Fenster, Teilbereichs-Steuerelemente, deren Größe geändert werden kann, modale Dialogfelder und Hilfefenster in Sprechblasenform.

Dieses Thema enthält folgende Abschnitte.

Implementierungsrichtlinien und Konventionen
Erforderliche Member für IWindowProvider
Ausnahmen
Verwandte Abschnitte

Implementierungsrichtlinien und Konventionen

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

Damit ein Steuerelement in der Lage ist, die Fenstergröße und die Bildschirmposition unter Verwendung der Benutzeroberflächenautomatisierung zu ändern, muss es ITransformProvider zusätzlich zu IWindowProvider implementieren.
Steuerelemente mit Titelleisten und Titelleistenelemente, mit denen das Steuerelement verschoben, maximiert, minimiert, geschlossen oder in der Größe verändert werden kann, sind in der Regel zum Implementieren von IWindowProvider erforderlich.
Steuerelemente wie QuickInfo-Popups und Dropdown-Kombinationsfelder oder -Menüs implementieren IWindowProvider normalerweise nicht.
Hilfefenster in Sprechblasenform unterscheiden sich von normalen QuickInfo-Popups darin, dass sie, wie Fenster, eine Schaltfläche zum Schließen besitzen.
Der Vollbildmodus wird von IWindowProvider nicht unterstützt, da dieses Feature anwendungsspezifisch und kein typisches Fensterverhalten ist.

Erforderliche Member für IWindowProvider

Für die IWindowProvider-Schnittstelle sind die folgenden Eigenschaften, Methoden und Ereignisse erforderlich.

Erforderliche Member	Membertyp	Hinweise
InteractionState	Eigenschaft	Keine
IsModal	Eigenschaft	Keine
IsTopmost	Eigenschaft	Keine
Maximizable	Eigenschaft	Keine
Minimizable	Eigenschaft	Keine
VisualState	Eigenschaft	Keine
Close	Methode	Keine
SetVisualState	Methode	Keine
WaitForInputIdle	Methode	Keine
WindowClosedEvent	Ereignis	Keine
WindowOpenedEvent	Ereignis	Keine
WindowInteractionState	Ereignis	Nicht sichergestellt, dass es ReadyForUserInteraction ist.

Ausnahmen

Anbieter müssen die folgenden Ausnahmen auslösen.

Ausnahmetyp	Bedingung
InvalidOperationException	SetVisualState Wenn ein Steuerelement ein angefordertes Verhalten nicht unterstützt.
ArgumentOutOfRangeException	WaitForInputIdle Wenn der Parameter keine gültige Zahl ist.

InvalidOperationException

SetVisualState