Udostępnij za pośrednictwem

Implementacja wzorca formantu dokowania automatyzacji interfejsu użytkownika

  • Artykuł

Uwaga

Ta dokumentacja jest przeznaczona dla deweloperów programu .NET Framework, którzy chcą używać zarządzanych klas automatyzacja interfejsu użytkownika zdefiniowanych w System.Windows.Automation przestrzeni nazw. Aby uzyskać najnowsze informacje na temat automatyzacja interfejsu użytkownika, zobacz Interfejs API usługi Windows Automation: 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 automatyzacja interfejsu użytkownika Clients (Mapowanie wzorca kontrolek dla klientów automatyzacja interfejsu użytkownika).

Docking container with two docked children. Przykład dokowania z programu Visual Studio, w którym okno "Widok klasy" to DockPosition.Right, a okno "Lista błędów" to 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 ż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 DockPositionzadokowania ich . Jeśli na przykład Top zostanie określony, po lewej i prawej stronie kontrolki zostanie rozwinięta w celu wypełnienia dowolnego dostępnego miejsca. 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 elementy członkowskie dla dostawcy IDockProvider

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

Wymagane elementy członkowskie Typ elementu członkowskiego Uwagi
DockPosition Właściwości Brak
SetDockPosition Method Brak

Ten wzorzec kontrolki nie ma skojarzonych zdarzeń.

Wyjątki

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

Typ wyjątku Stan
InvalidOperationException SetDockPosition

— Gdy kontrolka nie może wykonać żądanego stylu dokowania.

Zobacz też