Implementowanie wzorca kontrolki Dock dla automatyzacji interfejsu użytkownika

Uwaga / Notatka

Ta dokumentacja jest przeznaczona dla deweloperów programu .NET Framework, którzy chcą używać zarządzanych klas automatyzacji interfejsu użytkownika zdefiniowanych w przestrzeni nazw System.Windows.Automation. Aby uzyskać najnowsze informacje na temat automatyzacji interfejsu użytkownika, zobacz Windows Automation API: Automatyzacja interfejsu użytkownika.

W tym temacie przedstawiono wytyczne i konwencje implementacji IDockProvider, w tym informacje o właściwościach. Linki do dodatkowych odwołań znajdują się na końcu tematu.

Wzorzec DockPattern kontrolki służy do uwidaczniania właściwości dokowania 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. Przykłady kontrolek implementujących ten wzorzec kontrolki można znaleźć w temacie Control Pattern Mapping for UI Automation Clients.

Przykład dokowania w Visual Studio, gdzie okno "Widok klasy" ma DockPosition.Right, a okno "Lista błędów" ma DockPosition.Bottom

Wytyczne i konwencje implementacji

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

• IDockProvider nie uwidacznia żadnych właściwości kontenera dokowania ani właściwości kontrolek zadokowanych obok bieżącej kontrolki 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 zmienią rozmiar, aby wypełnić dowolne miejsce w kontenerze zgodnie z zachowaniem ich zadokowania DockPosition. Na przykład, jeśli określono Top, lewa i prawa strona kontrolki zostaną rozwinięte, aby wypełnić dostępne miejsce. Jeśli Fill zostanie określony, wszystkie cztery strony kontrolki zostaną rozwinięte, aby wypełnić dowolne dostępne miejsce.

• 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 członki dla interfejsu IDockProvider

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

Wymagani członkowie	Typ członkostwa	Notatki
DockPosition	Majątek	Żaden
SetDockPosition	Metoda	Żaden

Ten wzorzec kontrolki nie ma skojarzonych zdarzeń.

Wyjątki

Dostawcy muszą zgłaszać następujące wyjątki.

Typ wyjątku	Warunek
InvalidOperationException	SetDockPosition — Gdy kontrolka nie może wykonać żądanego stylu dokowania.

Zobacz także

• Omówienie wzorców automatyzacji kontrolek interfejsu użytkownika
• obsługują wzorce kontrolek w dostawcy automatyzacji interfejsu użytkownika
• Wzorce kontrolek automatyzacji interfejsu użytkownika dla klientów
• Omówienie drzewa automatyzacji interfejsu użytkownika
• Użyj buforowania w automatyzacji interfejsu użytkownika