Freigeben über

Dock-Steuerelementmuster

  • Artikel

Beschreibt Richtlinien und Konventionen für die Implementierung von IDockProvider, einschließlich Informationen zu Eigenschaften und Methoden. Das Dock-Steuerelementmuster wird verwendet, um die Dockeigenschaften eines Steuerelements in einem Andockcontainer verfügbar zu machen.

Ein Dockingcontainer ist ein Steuerelement, mit dem untergeordnete Elemente horizontal oder vertikal zueinander ausgerichtet werden können. Die folgende Abbildung zeigt einen Andockcontainer mit zwei untergeordneten Elementen. Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Steuerelementtypen und ihre unterstützten Steuerelementmuster.

Screenshot: Andockcontainer mit zwei angedockten untergeordneten Elementen

Dieses Thema enthält folgende Abschnitte:

Implementierungsrichtlinien und -konventionen

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

  • IDockProvider macht keine Eigenschaften des Andockcontainers oder eigenschaften von Steuerelementen verfügbar, die neben dem aktuellen Steuerelement im Andockcontainer angedockt sind.
  • Steuerelemente werden relativ zueinander entsprechend ihrer aktuellen z-Reihenfolge angeordnet. Je höher ihre z-Reihenfolgenposition ist, desto weiter entfernt vom angegebenen Rand des Dockingcontainers werden sie platziert.
  • Wenn die Größe des Dockingcontainers geändert wird, werden alle angedockten Steuerelemente im Container bündig zu derselben Kante neu positioniert, an der sie ursprünglich angedockt waren. Die angedockten Steuerelemente ändern auch die Größe, um jeden Platz innerhalb des Containers entsprechend dem Andockverhalten ihrer DockPosition-Eigenschaft zu füllen. Wenn beispielsweise DockPosition_Top angegeben wird, erweitern sich die linke und rechte Seite des Steuerelements, um den verfügbaren Platz zu füllen. Wenn DockPosition_Fill angegeben ist, werden alle vier Seiten des Steuerelements erweitert, um den verfügbaren Speicherplatz zu füllen.
  • Auf einem System mit mehreren Bildschirmen sollten Steuerelemente auf der linken oder rechten Seite des aktuellen Bildschirms andocken. Ist dies nicht möglich, 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.

Erforderliche Member für IDockProvider

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

Erforderliche Member Memberart Hinweise
Dockposition Eigenschaft Keine
SetDockPosition Methode Keine

 

Diesem Steuerelementmuster sind keine Ereignisse zugeordnet.

Steuerelementtypen und ihre unterstützten Steuerelementmuster

Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierungs-Struktur