Freigeben über

Implementieren des Window-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 IWindowProvidervorgestellt, einschließlich Informationen zu WindowPattern Eigenschaften, Methoden und Ereignissen. Links zu zusätzlichen Verweisen werden am Ende des Themas aufgeführt.

Das WindowPattern Steuerelementmuster wird verwendet, um Steuerelemente zu unterstützen, die grundlegende fensterbasierte Funktionen in einer herkömmlichen grafischen Benutzeroberfläche (GUI) bereitstellen. Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren müssen, sind Anwendungsfenster der obersten Ebene, untergeordnete MDI-Fenster (Multiple-Document Interface), anpassbare Steuerelemente für geteilte Bereiche, modale Dialogfelder und Sprechblasen-Hilfefenster.

Implementierungsrichtlinien und -konventionen

Beachten Sie bei der Implementierung des Fenstersteuerelementmusters die folgenden Richtlinien und Konventionen:

  • Um die Möglichkeit zu unterstützen, sowohl die Fenstergröße als auch die Bildschirmposition mithilfe der Benutzeroberflächenautomatisierung zu ändern, muss ein Steuerelement ITransformProvider zusätzlich zu IWindowProvider implementieren.

  • Steuerelemente, die Titelleisten und Titelleistenelemente enthalten, mit denen das Steuerelement verschoben, verkleinert, maximiert, minimiert oder geschlossen werden kann, sind in der Regel erforderlich, um es zu implementieren IWindowProvider.

  • 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 für eine Anwendung featurespezifisch ist und kein typisches Fensterverhalten ist.

Erforderliche Member für IWindowProvider

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

Erforderliches Mitglied Elementtyp Hinweise
InteractionState Eigentum Nichts
IsModal Eigentum Nichts
IsTopmost Eigentum Nichts
Maximizable Eigentum Nichts
Minimizable Eigentum Nichts
VisualState Eigentum Nichts
Close Methode Nichts
SetVisualState Methode Nichts
WaitForInputIdle Methode Nichts
WindowClosedEvent Ereignis Nichts
WindowOpenedEvent Ereignis Nichts
WindowInteractionState Ereignis ReadyForUserInteraction

Ausnahmen

Anbieter müssen die folgenden Ausnahmen auslösen.

Ausnahmetyp Zustand
InvalidOperationException SetVisualState

– Wenn ein Steuerelement ein angefordertes Verhalten nicht unterstützt.
ArgumentOutOfRangeException WaitForInputIdle

- Wenn der Parameter keine gültige Zahl ist.

Siehe auch

  • Last updated on