Typ kontrolki tabulacji
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla tabulatora typu kontrolki.
Kontrolka tabulatora jest analogiczna do rozdzielaczy w notesie lub etykietach w szafce plików. Za pomocą kontrolki tabulatora aplikacja może definiować wiele stron dla tego samego obszaru okna lub okna dialogowego.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla tabulatora typu kontrolki. Wymagania automatyzacji interfejsu użytkownika mają zastosowanie do wszystkich kontrolek kart, 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, który odnosi się do kontrolek tabulacji 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 |
|---|---|
|
|
Kontrolki tabulacji mają podrzędne elementy automatyzacji interfejsu użytkownika na podstawie TabItem typu kontrolki. Gdy elementy karty są grupowane (na przykład w aplikacjach pakietu Microsoft Office), tabulator typ kontrolki może również hostować grupy typy kontrolek dla grupowanych elementów tabulacji, jak pokazuje poniższa struktura drzewa.
| Widok kontrolki | Widok 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 kontrolek tabulacji. 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 | Nie | Kontrolka karty nie ma punktów, które można klikać. |
| UIA_ControlTypePropertyId | kart | |
| UIA_IsContentElementPropertyId | PRAWDZIWY | Kontrolka karty jest zawsze uwzględniana w widoku zawartości drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsControlElementPropertyId | PRAWDZIWY | Kontrolka karty jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsKeyboardFocusablePropertyId | PRAWDZIWY | Typ kontrolki Tab musi mieć możliwość odbierania fokusu klawiatury. Zazwyczaj klient automatyzacji interfejsu użytkownika wywołuje IUIAutomationElement::SetFocus na kontrolce karty, a jeden z jego elementów przekazuje fokus klawiatury do kontrolki tabulacji. W przypadku niektórych kontenerów kart można skupić się bez ustawiania fokusu na jednym z jego elementów. |
| UIA_LabeledByPropertyId | Zobacz uwagi. | Kontrolki tabulacji zwykle mają statyczną etykietę tekstową uwidacznianą za pośrednictwem tej właściwości. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający typowi kontrolki Tab. Wartość domyślna to "tab" dla en-US lub angielski (Stany Zjednoczone). |
| UIA_NamePropertyId | Zobacz uwagi. | Kontrolka karty rzadko wymaga właściwości Name. |
| UIA_OrientationPropertyId | Zobacz uwagi. | Kontrolka tabulacji musi zawsze wskazywać, czy jest umieszczona w poziomie, czy w pionie. |
Wymagane wzorce kontrolek
W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi wszystkich kontrolek kart. 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 |
|---|---|---|
| ISelectionProvider | Wymagane | Wszystkie kontrolki kart muszą obsługiwać wzorzec kontrolki Selection. |
| IsSelectionRequired | PRAWDZIWY | Kontrolki tabulacji zawsze wymagają wyboru. |
| CanSelectMultiple | FAŁSZYWY | Kontrolki tabulacji są zawsze kontenerami z jednym wyborem. |
| IScrollProvider | Zależy | Wzorzec kontrolki przewijania musi być obsługiwany, jeśli kontrolka karty zawiera widżety, które umożliwiają przewijanie zestawu elementów tabulacji. |
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika, które są wymagane do obsługi kontrolek kart. 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_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 |
Tematy pokrewne