Implementacja wzorca kontroli okna 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 IWindowProvider, w tym informacje o WindowPattern właściwościach, metodach i zdarzeniach. Linki do dodatkowych odwołań znajdują się na końcu tematu.

Wzorzec WindowPattern kontrolki służy do obsługi kontrolek zapewniających podstawowe funkcje oparte na oknach w tradycyjnym graficznym interfejsie użytkownika (GUI). Przykłady kontrolek, które muszą implementować ten wzorzec kontrolki, to okna aplikacji najwyższego poziomu, okna podrzędne interfejsu wielodokumentowego (MDI, multiple-document interface, resizable split pane controls, modalne okna dialogowe i okna pomocy balonowej).

Wytyczne i konwencje implementacji

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

• Aby obsługiwać możliwość modyfikowania zarówno rozmiaru okna, jak i położenia ekranu przy użyciu automatyzacji interfejsu użytkownika, kontrolka musi implementować ITransformProvider oprócz IWindowProvider funkcji.

• Kontrolki, które zawierają paski tytułu i elementy paska tytułu umożliwiające przenoszenie, zmienianie rozmiaru, maksymalizowanie, minimalizowanie lub zamykanie kontrolki, są zazwyczaj wymagane do zaimplementowania IWindowProvider.

• Kontrolki, takie jak wyskakujące okienka narzędzi i pola kombi lub listy rozwijane menu, zwykle nie implementują polecenia IWindowProvider.

• Okna pomocy balonowej różnią się od podstawowych wyskakujących okienek narzędzi, ponieważ są wyposażone w przycisk Zamknij, podobny do tych, które można znaleźć w oknach.

• Tryb pełnoekranowy nie jest obsługiwany przez dostawcę IWindowProvider, ponieważ jest specyficzny dla funkcji aplikacji i nie jest typowym zachowaniem okna.

Wymagane elementy członkowskie dla IWindowProvider

Następujące właściwości, metody i zdarzenia są wymagane dla interfejsu IWindowProvider.

Wymagany członek	Typ członkostwa	Notatki
InteractionState	Majątek	Żaden
IsModal	Majątek	Żaden
IsTopmost	Majątek	Żaden
Maximizable	Majątek	Żaden
Minimizable	Majątek	Żaden
VisualState	Majątek	Żaden
Close	Metoda	Żaden
SetVisualState	Metoda	Żaden
WaitForInputIdle	Metoda	Żaden
WindowClosedEvent	Zdarzenie	Żaden
WindowOpenedEvent	Zdarzenie	Żaden
WindowInteractionState	Zdarzenie	Nie ma gwarancji, że ReadyForUserInteraction

Wyjątki

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

Typ wyjątku	Warunek
InvalidOperationException	SetVisualState — Jeśli kontrolka nie obsługuje żądanego zachowania.
ArgumentOutOfRangeException	WaitForInputIdle - Jeśli parametr nie jest prawidłową liczbą.

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