Udostępnij za pośrednictwem

Implementacja wzorca kontrolki okna 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 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 automatyzacja interfejsu użytkownika, kontrolka musi implementować ITransformProvider oprócz IWindowProviderelementu .

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

  • 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 dzięki aprowizacji przycisku Zamknij przypominającego okno.

  • 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 element członkowski Typ elementu członkowskiego Uwagi
InteractionState Właściwości Brak
IsModal Właściwości Brak
IsTopmost Właściwości Brak
Maximizable Właściwości Brak
Minimizable Właściwości Brak
VisualState Właściwości Brak
Close Method Brak
SetVisualState Method Brak
WaitForInputIdle Method Brak
WindowClosedEvent Zdarzenie Brak
WindowOpenedEvent Zdarzenie Brak
WindowInteractionState Zdarzenie Nie ma gwarancji, że ReadyForUserInteraction

Wyjątki

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

Typ wyjątku Stan
InvalidOperationException SetVisualState

— Jeśli kontrolka nie obsługuje żądanego zachowania.
ArgumentOutOfRangeException WaitForInputIdle

- Jeśli parametr nie jest prawidłową liczbą.

Zobacz też