Typ kontrolki tabeli
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla typu kontrolki tabeli.
Kontrolki tabeli zawierają wiersze i kolumny tekstowe oraz, opcjonalnie, nagłówki wierszy i nagłówki kolumn.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Table. Wymagania automatyzacji interfejsu użytkownika dotyczą wszystkich kontrolek tabeli, 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 tabeli 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 |
|---|---|
|
|
Jeśli kontrolka tabeli zawiera nagłówki wierszy lub kolumn, muszą być uwidocznione w widoku sterowania drzewa automatyzacji interfejsu użytkownika. Widok zawartości nie musi ujawniać tych informacji, ponieważ można uzyskać do niego dostęp przy użyciu interfejsu IUIAutomationTablePattern.
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 tabeli. 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. | 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 | tabeli | |
| UIA_DescribedByPropertyId | Zobacz uwagi. | Jeśli tabela jest oznaczona adnotacją przez inny element interfejsu użytkownika (na przykład element tekstowy, który zawiera opis tabeli), właściwość DescribedBy powinna uwidocznić odwołanie do elementu automatyzacji kontrolki tekstu. |
| UIA_HelpTextPropertyId | Zobacz uwagi. | Więcej szczegółów na temat przeznaczenia tabeli powinno być uwidocznione za pośrednictwem tej właściwości, jeśli nie jest wystarczająco wyjaśnione przez właściwość UIA_NamePropertyId. |
| UIA_IsContentElementPropertyId | PRAWDZIWY | Kontrolka tabeli musi zawsze być wyświetlana w widoku zawartości drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsControlElementPropertyId | PRAWDZIWY | Kontrolka tabeli musi zawsze być wyświetlana 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 | Zobacz uwagi. | Jeśli istnieje statyczna etykieta tekstowa, ta właściwość powinna uwidocznić odwołanie do elementu automatyzacji kontrolki. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający typowi kontrolki Table. Wartość domyślna to "table" dla en-US lub angielski (Stany Zjednoczone). |
| UIA_NamePropertyId | Zobacz uwagi. | Kontrolka tabeli zazwyczaj pobiera wartość nazwy z etykiety tekstowej statycznej. Jeśli nie ma statycznej etykiety tekstowej, element musi przypisać właściwość Name, która musi być zawsze dostępna, aby wyjaśnić przeznaczenie tabeli. |
Wymagane wzorce kontrolek
W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi wszystkich kontrolek tabeli. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie.
| Wzorzec kontrolki | Wsparcie | Notatki |
|---|---|---|
| IGridProvider | Wymagane | Ponieważ kontrolka tabeli zawiera elementy przedstawione w siatce, zawsze obsługuje wzorzec kontrolki Grid. |
| IGridItemProvider | Wymagane z obiektami podrzędnymi | Obiekty wewnętrzne tabeli powinny obsługiwać wzorce kontrolek GridItem i TableItem. Sama tabela nie musi obsługiwać wzorca kontrolki GridItem lub TableItem, chyba że tabela jest częścią innej tabeli. |
| ITableProvider | Wymagane | Kontrolka tabeli zawsze może mieć nagłówki skojarzone z zawartością. |
| ITableItemProvider | Wymagane z obiektami podrzędnymi | Obiekty wewnętrzne tabeli powinny obsługiwać wzorce kontrolek GridItem i TableItem. Sama tabela nie musi obsługiwać wzorców kontrolek GridItem lub TableItem, chyba że tabela jest częścią innej tabeli. |
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika wymagane do obsługi kontrolek tabeli. 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