Udostępnij za pośrednictwem


Wzorzec kontrolki Dock

Opisuje wytyczne i konwencje implementowania IDockProvider, w tym informacje o właściwościach i metodach. Wzorzec sterowania Dock służy do uwidaczniania właściwości docku kontrolki w kontenerze dokowania.

Kontener dokowania to kontrolka, która umożliwia rozmieszczanie elementów podrzędnych w poziomie i w pionie względem siebie. Na poniższej ilustracji przedstawiono kontener dokowania z dwoma elementami podrzędnymi. Aby zapoznać się z przykładami kontrolek implementujących ten wzorzec kontrolki, zobacz typy kontrolek i obsługiwane wzorce kontrolek.

zrzut ekranu przedstawiający kontener dokowania z dwoma zadokowanych

Ten temat zawiera następujące sekcje.

Wytyczne i konwencje implementacji

Podczas implementowania wzorca sterowania Dock należy pamiętać o następujących wytycznych i konwencjach:

  • IDockProvider nie ujawnia żadnych właściwości kontenera dokowania ani żadnych właściwości kontrolek, które są zadokowane sąsiadująco z bieżącą kontrolką w kontenerze dokowania.
  • Kontrolki są zadokowane względem siebie na podstawie ich bieżącej kolejności z; im wyższa ich kolejność z, tym dalej są umieszczane z określonej krawędzi kontenera dokowania.
  • Jeśli rozmiar kontenera dokowania zostanie zmieniony, wszystkie zadokowane kontrolki w kontenerze zostaną przesunięte do tej samej krawędzi, do której zostały pierwotnie zadokowane. Zadokowane kontrolki również zmienią rozmiar, aby wypełnić dowolne miejsce w kontenerze zgodnie z zachowaniem dokowania właściwości DockPosition. Jeśli na przykład DockPosition_Top zostanie określona, lewe i prawe strony kontrolki zostaną rozwinięte, aby wypełnić dowolne dostępne miejsce. Jeśli DockPosition_Fill zostanie określona, wszystkie cztery strony kontrolki zostaną rozwinięte w celu wypełnienia dowolnego dostępnego miejsca.
  • W systemie z wieloma monitorami kontrolki powinny być dokowane do lewej lub prawej strony bieżącego monitora. Jeśli nie jest to możliwe, powinny one zadokować do lewej strony monitora z lewej strony lub po prawej stronie monitora po prawej stronie.

Wymagane elementy członkowskie IDockProvider

Następujące właściwości i metody są wymagane do zaimplementowania interfejsu IDockProvider.

Wymagane elementy członkowskie Typ elementu członkowskiego Notatki
DockPosition Własność Żaden
SetDockPosition Metoda Żaden

 

Ten wzorzec kontrolki nie ma skojarzonych zdarzeń.

typów kontrolek i ich obsługiwanych wzorców kontrolek

Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie

Omówienie drzewa automatyzacji interfejsu użytkownika