Udostępnij za pośrednictwem

Wzorzec kontrolki okna

  • Artykuł

Opisuje wytyczne i konwencje implementowania IWindowProvider, w tym informacje o właściwościach, metodach i zdarzeniach. Wzorzec kontrolki okna obsługuje kontrolki, które zapewniają podstawowe funkcje oparte na oknach w tradycyjnym graficznym interfejsie użytkownika.

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). Przykłady kontrolek implementujących ten wzorzec kontrolki można znaleźć w temacie Control Pattern Mapping for UI Automation Clients.

Ten temat zawiera następujące sekcje.

Wytyczne i konwencje implementacji

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

  • Aby umożliwić modyfikowanie zarówno rozmiaru okna, jak i położenia ekranu przy użyciu automatyzacji interfejsu użytkownika firmy Microsoft, kontrolka musi implementować ITransformProvider oprócz IWindowProvider.
  • Kontrolki zawierające paski tytułu i elementy paska tytułu umożliwiające przenoszenie, zmienianie rozmiaru, zmaksymalizowanie, zminimalizowanie lub zamknięcie kontrolki są zwykle wymagane do zaimplementowania IWindowProvider.
  • Kontrolki, takie jak wyskakujące okienka narzędzi i listy rozwijane menu lub menu, zwykle nie implementują IWindowProvider.
  • Okna pomocy balonowej różnią się od podstawowych wyskakujących okienek narzędzi dzięki aprowizacji przycisku Zamknij okna.
  • Tryb pełnoekranowy nie jest obsługiwany przez IWindowProvider, ponieważ jest on specyficzny dla aplikacji i nie jest typowym zachowaniem okna.

Wymagane elementy członkowskie IWindowProvider

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

Wymagane elementy członkowskie Typ elementu członkowskiego Notatki
WindowInteractionState Własność Nie ma gwarancji, że WindowInteractionState_ReadyForUserInteraction
IsModal Własność Żaden
IsTopmost Własność Żaden
CanMaximize Własność Żaden
CanMinimize Własność Żaden
WindowVisualState Własność Żaden
Zamknij Metoda Żaden
SetVisualState Metoda Żaden
WaitForInputIdle Metoda Żaden
UIA_Window_WindowClosedEventId Zdarzenie Żaden
UIA_Window_WindowOpenedEventId Zdarzenie Żaden

 

koncepcyjne

Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie

mapowanie wzorca kontrolki dla klientów automatyzacji interfejsu użytkownika

Omówienie drzewa automatyzacji interfejsu użytkownika