Udostępnij za pośrednictwem

Typ kontrolki okna

  • Artykuł

Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla okna typu kontrolki.

Kontrolka okna składa się z ramki okna, która zawiera obiekty podrzędne, takie jak pasek tytułu, klient i inne obiekty.

W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki okna. Wymagania automatyzacji interfejsu użytkownika dotyczą wszystkich kontrolek okien, w których platforma/platforma interfejsu użytkownika integruje obsługę automatyzacji interfejsu użytkownika dla typów kontrolek i wzorców kontrolek.

Ten temat zawiera następujące sekcje.

Typowa struktura drzewa

W poniższej tabeli przedstawiono typowy widok kontrolki i zawartości drzewa automatyzacji interfejsu użytkownika, który odnosi się do kontrolek okien i opisuje, co można zawierać w każdym widoku. Aby uzyskać więcej informacji na temat drzewa automatyzacji interfejsu użytkownika, zobacz Omówienie drzewa automatyzacji interfejsu użytkownika.

Widok kontrolki Widok zawartości
  • Okno
  • Okno

 

Odpowiednie właściwości

W poniższej tabeli wymieniono właściwości automatyzacji interfejsu użytkownika, których wartość lub definicja jest szczególnie istotna dla kontrolek okien. Aby uzyskać więcej informacji na temat właściwości automatyzacji interfejsu użytkownika, zobacz Pobieranie właściwości z elementów automatyzacji interfejsu użytkownika.

Właściwość automatyzacji interfejsu użytkownika Wartość Notatki
UIA_AutomationIdPropertyId Zobacz uwagi. Wartość tej właściwości musi być unikatowa wśród wszystkich elementów równorzędnych w nieprzetworzonym widoku drzewa automatyzacji interfejsu użytkownika.
UIA_BoundingRectanglePropertyId Zobacz uwagi. Najbardziej oddalony prostokąt, który zawiera całą kontrolkę.
UIA_ClickablePointPropertyId Zobacz uwagi. Kontrolka okna musi mieć punkt z możliwością kliknięcia, który powoduje, że okno zostanie zaznaczone lub niezaznaczone.
UIA_ControlTypePropertyId okna Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika.
UIA_IsContentElementPropertyId PRAWDZIWY Kontrolka okna jest zawsze uwzględniana w widoku zawartości drzewa automatyzacji interfejsu użytkownika.
UIA_IsControlElementPropertyId PRAWDZIWY Kontrolka okna jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacji interfejsu użytkownika.
UIA_IsKeyboardFocusablePropertyId Zobacz uwagi. Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość.
UIA_LabeledByPropertyId ZERO Kontrolki okien nie mają statycznej etykiety okna.
UIA_LocalizedControlTypePropertyId Zobacz uwagi. Zlokalizowany ciąg odpowiadający typowi kontrolki okna . Wartość domyślna to "window" dla en-US lub angielski (Stany Zjednoczone).
UIA_NamePropertyId Zobacz uwagi. Kontrolka okna zawsze zawiera element okna podstawowego, który odnosi się do tego, co użytkownik skojarzy jako najbardziej semantyczny identyfikator elementu.

 

Wymagane wzorce kontrolek

W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi przez kontrolki okien. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie.

Wzorzec/wzorzec kontrolki, właściwość Pomoc techniczna/wartość Notatki
IDockProvider Warunkowy Wzorzec sterowania docku musi być obsługiwany, jeśli okno może być zadokowane.
ITransformProvider Wymagane Wzorzec sterowania Transform umożliwia przenoszenie, zmienianie rozmiaru lub obracanie okna na ekranie. (Nie dotyczy aplikacji ze Sklepu Windows).
IWindowProvider Wymagane Wzorzec sterowania Okna umożliwia wykonywanie określonych operacji dla okna.

 

Zdarzenia wymagane

W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika, które kontrolki okna są wymagane do obsługi. Aby uzyskać więcej informacji na temat zdarzeń, zobacz Omówienie zdarzeń automatyzacji interfejsu użytkownika.

Zdarzenie automatyzacji interfejsu użytkownika Notatki
UIA_AsyncContentLoadedEventId
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId zdarzenie zmienione właściwości.
UIA_IsEnabledPropertyId zdarzenie zmienione właściwości. Jeśli kontrolka obsługuje właściwość IsEnabled, musi obsługiwać to zdarzenie.
UIA_IsOffscreenPropertyId zdarzenie zmienione właściwości. Jeśli kontrolka obsługuje właściwość IsOffscreen, musi obsługiwać to zdarzenie.
UIA_LayoutInvalidatedEventId
UIA_NamePropertyId zdarzenie zmienione właściwości.
UIA_ScrollHorizontallyScrollablePropertyId zdarzenie zmienione właściwości. Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie.
UIA_ScrollHorizontalScrollPercentPropertyId zdarzenie zmienione właściwości. Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie.
UIA_ScrollHorizontalViewSizePropertyId zdarzenie zmienione właściwości. Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie.
UIA_ScrollVerticallyScrollablePropertyId zdarzenie zmienione właściwości. Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie.
UIA_ScrollVerticalScrollPercentPropertyId zdarzenie zmienione właściwości. Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie.
UIA_ScrollVerticalViewSizePropertyId zdarzenie zmienione właściwości. Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie.
UIA_StructureChangedEventId
UIA_Window_WindowClosedEventId
UIA_Window_WindowOpenedEventId
UIA_WindowWindowVisualStatePropertyId zdarzenie zmienione właściwości. Jeśli kontrolka obsługuje właściwość WindowVisualState wzorca kontrolki okna, to zdarzenie musi być obsługiwane.

 

koncepcyjne

typy kontrolek automatyzacji interfejsu użytkownika — omówienie

Omówienie automatyzacji interfejsu użytkownika