Implementieren des Window-Steuerelementmusters der Benutzeroberflächenautomatisierung

  • Artikel

Hinweis

Diese Dokumentation ist für .NET Framework-Entwickler konzipiert, die die verwalteten Klassen zur Automatisierung der Benutzeroberfläche verwenden möchten, die im Namespace System.Windows.Automation definiert sind. Aktuelle Informationen zur Automatisierung der Benutzeroberfläche finden Sie auf der Seite zur Windows-Automatisierungs-API: Benutzeroberflächenautomatisierung.

Dieses Thema enthält Richtlinien und Konventionen für das Implementieren von IWindowProvider, einschließlich Informationen über WindowPattern -Eigenschaften, -Methoden und -Ereignisse. Links zu zusätzlichen Referenzen sind am Ende dieses Themas aufgelistet.

Das WindowPattern-Steuerelementmuster wird zur Unterstützung von Steuerelementen verwendet, die grundlegende fensterbasierte Funktionen in einer herkömmlichen grafischen Benutzeroberfläche (GUI) bereitstellen. Beispiele für Steuerelemente, für die dieses Steuerelementmuster implementiert werden muss, sind Anwendungsfenster der obersten Ebene, untergeordnete MDI-Fenster (Multiple-Document Interface), Teilbereichs-Steuerelemente, deren Größe geändert werden kann, modale Dialogfelder und Hilfefenster in Sprechblasenform.

Implementierungsrichtlinien und -konventionen

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

  • Damit ein Steuerelement in der Lage ist, Fenstergröße und Bildschirmposition über Benutzeroberflächenautomatisierung zu ändern, muss es ITransformProvider zusätzlich zu IWindowProviderimplementieren.

  • Für Steuerelemente, die Titelleisten und Titelleistenelemente enthalten, mit denen das Steuerelement verschoben, maximiert, minimiert, geschlossen oder in der Größe verändert werden kann, muss üblicherweise IWindowProviderimplementiert werden.

  • Für Steuerelemente wie QuickInfo-Popups und Dropdown-Kombinationsfelder oder -Menüs muss IWindowProvidernormalerweise nicht implementiert werden.

  • Hilfefenster in Sprechblasenform unterscheiden sich von normalen QuickInfo-Popups darin, dass sie eine wie für Fenster verwendete Schaltfläche zum Schließen bereitstellen.

  • Der Vollbildmodus wird von IWindowProvider nicht unterstützt, da er featurespezifisch für eine Anwendung und kein typisches Fensterverhalten ist.

Erforderliche Member für IWindowProvider

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

Erforderlicher Member Memberart 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 ReadyForUserInteraction

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.

Siehe auch