Freigeben über

Implementieren des Dock-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 IDockProvidervorgestellt, einschließlich Informationen zu Eigenschaften. Links zu zusätzlichen Verweisen werden am Ende des Themas aufgeführt.

Das DockPattern -Steuerelementmuster wird verwendet, um Andockeigenschaften eines Steuerelements in einem Dockingcontainer verfügbar zu machen. Ein Dockingcontainer ist ein Steuerelement, mit dem Sie untergeordnete Elemente horizontal und vertikal relativ zueinander anordnen können. Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Steuerelementmusterzuordnung für Benutzeroberflächenautomatisierungs-Clients.

Andockcontainer mit zwei angedockten untergeordneten Elementen. Andockbeispiel aus Visual Studio, in dem das Fenster „Klassenansicht“ die DockPosition.Right und das Fenster „Fehlerliste“ die DockPosition.Bottom ist.

Implementierungsrichtlinien und -konventionen

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

  • IDockProvider macht keine Eigenschaften des Dockingcontainers oder eigenschaften von Steuerelementen verfügbar, die neben dem aktuellen Steuerelement innerhalb des Dockingcontainers verankert sind.

  • Steuerelemente werden relativ zueinander basierend auf ihrer aktuellen Z-Reihenfolge angedockt; je höher ihre Z-Ordnungsplatzierung, desto weiter werden sie vom angegebenen Rand des Dockingcontainers platziert.

  • Wenn die Größe des Andockcontainers geändert wird, werden alle angedockten Steuerelemente innerhalb des Containers an demselben Rand neu positioniert, an dem sie ursprünglich angedockt wurden. Die Größe der angedockten Steuerelemente wird ebenfalls geändert, um den Platz innerhalb des Containers entsprechend dem Andockverhalten ihrer DockPositionauszufüllen. Wenn beispielsweise Top angegeben, wird die linke und rechte Seite des Steuerelements erweitert, um den verfügbaren Platz auszufüllen. Wenn Fill angegeben, werden alle vier Seiten des Steuerelements erweitert, um den verfügbaren Platz auszufüllen.

  • Auf einem System mit mehreren Monitoren sollten Steuerelemente links oder rechts neben dem aktuellen Monitor angedockt werden. Wenn dies nicht möglich ist, sollten sie auf der linken Seite des äußerst linken Monitors oder der rechten Seite des äußerst rechten Bildschirms andocken.

Erforderliche Mitglieder für IDockProvider

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

Erforderliche Mitglieder Elementtyp Hinweise
DockPosition Eigentum Nichts
SetDockPosition Methode Nichts

Dieses Steuerelementmuster hat keine zugehörigen Ereignisse.

Ausnahmen

Anbieter müssen die folgenden Ausnahmen auslösen.

Ausnahmetyp Zustand
InvalidOperationException SetDockPosition

– Wenn ein Steuerelement die geforderte Andockart nicht ausführen kann.

Siehe auch

  • Last updated on