Implementieren des Dock-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.

Dieses Thema enthält Richtlinien und Konventionen zum Implementieren von IDockProvider sowie Informationen über Eigenschaften. Am Ende des Themas finden Sie Links zu zusätzlichen Verweisen.

Das DockPattern-Steuerelementmuster wird verwendet, um Andockeigenschaften eines Steuerelements in einem Andockcontainer verfügbar zu machen. Ein Andockcontainer ist ein Steuerelement, mit dem untergeordnete Elemente horizontal oder vertikal zueinander ausgerichtet werden können. Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Zuordnen von Steuerelementmustern für Benutzeroberflächenautomatisierungs-Clients.

Andockbeispiel für Visual Studio, in dem das Fenster "Klassenansicht" die DockPosition.Right hat und das Fenster "Fehlerliste" die DockPosition.Bottom

Andock-Container mit zwei angedockten untergeordneten Elementen.

Dieses Thema enthält folgende Abschnitte.

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

Implementierungsrichtlinien und Konventionen

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

IDockProvider macht keine Eigenschaften des Andockcontainers bzw. der Steuerelemente verfügbar, die neben dem aktuellen Steuerelement im Andockcontainer angedockt werden können.
Steuerelemente werden relativ zueinander auf Grundlage der aktuellen z-Reihenfolge angeordnet. Je höher die z-Reihenfolge-Position, desto weiter entfernt vom angegebenen Rand des Andockcontainers werden sie platziert.
Wenn die Größe des Andockcontainers geändert wird, werden alle angedockten Steuerelemente innerhalb des Containers entlang der gleichen Kante neu positioniert, an der sie ursprünglich positioniert waren. Die Größe der angedockten Steuerelemente wird ebenfalls geändert, um den Platz innerhalb des Containers entsprechend dem Andockverhalten ihrer DockPosition auszufüllen. Wenn beispielsweise Top festgelegt ist, wird die linke und rechte Seite des Steuerelements erweitert, um den verfügbaren Platz auszufüllen. Wenn Fill festgelegt ist, werden alle vier Seiten des Steuerelements erweitert, um den verfügbaren Platz auszufüllen.
Auf einem System mit mehreren Bildschirmen sollten Steuerelemente auf der linken oder rechten Seite des aktuellen Bildschirms andocken. Wenn dies nicht möglich ist, sollten sie auf der linken Seite des am weitesten links stehenden Bildschirms bzw. auf der rechten Seite des am weitesten rechts stehenden Bildschirms angedockt werden.