Typ kontrolki TitleBar
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla TitleBar typu kontrolki. Kontrolka paska tytułu reprezentuje pasek tytułu lub podpisu w oknie.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki TitleBar. Wymagania automatyzacji interfejsu użytkownika dotyczą wszystkich kontrolek paska tytułu, 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
- odpowiednie właściwości
- wymagane wzorce kontrolek
- wymagane zdarzenia
- Tematy pokrewne
Typowa struktura drzewa
W poniższej tabeli przedstawiono typowy widok kontrolki i zawartości drzewa automatyzacji interfejsu użytkownika odnoszącego się do kontrolek paska tytułu i opisano, 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 |
|---|---|
|
(Nie dotyczy; kontrolka paska tytułu nie ma zawartości) |
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 typu kontrolki TitleBar. 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. | Wartość uwidoczniona przez tę właściwość musi zawierać wszystkie zawarte w niej kontrolki. |
| UIA_ClickablePointPropertyId | Zobacz uwagi. | Obsługiwane, jeśli istnieje prostokąt ograniczenia. Jeśli nie każdy punkt w obrębie prostokąta ograniczenia jest klikalny, a element wykonuje wyspecjalizowane testowanie trafień, przesłonięć i zapewnić punkt możliwy do kliknięcia. |
| UIA_ControlTypePropertyId | TitleBar | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| UIA_IsContentElementPropertyId | FAŁSZYWY | Kontrolka paska tytułu nigdy nie jest uwzględniana w widoku zawartości drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsControlElementPropertyId | PRAWDZIWY | Kontrolka paska tytułu jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsKeyboardFocusablePropertyId | FAŁSZYWY | Kontrolka paska tytułu nigdy nie ma fokusu klawiatury. |
| UIA_IsOffscreenPropertyId | Zależy | Kontrolka paska tytułu zwraca wartość w zależności od tego, czy jest ona widoczna na ekranie. |
| UIA_LabeledByPropertyId | Zobacz uwagi. | Kontrolka paska tytułu zwykle nie ma etykiety. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający typowi kontrolki TitleBar. Wartość domyślna to "pasek tytułu" dla en-US lub angielski (Stany Zjednoczone). |
| UIA_NamePropertyId | "" | Pasek tytułu nie jest zawartością; informacje tekstowe są udostępniane przez nazwę okna nadrzędnego. |
Wymagane wzorce kontrolek
Do obsługi wzorców kontrolek nie jest wymagana kontrolka TitleBar. Jego funkcjonalność jest uwidaczniona za pomocą wzorca kontrolki okna na typie kontrolki Window.
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika, które są wymagane do obsługi kontrolek paska tytułu. Aby uzyskać więcej informacji na temat zdarzeń, zobacz Omówienie zdarzeń automatyzacji interfejsu użytkownika.
| Zdarzenie automatyzacji interfejsu użytkownika | Notatki |
|---|---|
| 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_StructureChangedEventId |
Tematy pokrewne