Typ kontrolki tekstu
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla typu kontrolki Text.
Kontrolka tekstu to podstawowy element interfejsu użytkownika reprezentujący fragment tekstu na ekranie.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Text. Wymagania automatyzacji interfejsu użytkownika mają zastosowanie do wszystkich kontrolek drzewa, 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
W poniższej tabeli przedstawiono typowy widok kontrolki i zawartości drzewa automatyzacji interfejsu użytkownika odnoszącego się do kontrolek tekstu 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 |
|---|---|
|
|
Kontrolka tekstu może być używana samodzielnie jako etykieta lub jako tekst statyczny w formularzu. Może być również zawarty w strukturze jednego z następujących elementów:
Kontrolki tekstu mogą nie być wyświetlane w widoku zawartości drzewa automatyzacji interfejsu użytkownika, ponieważ tekst jest często wyświetlany za pośrednictwem właściwości Name innej kontrolki. Na przykład tekst używany do etykietowania kontrolki pola kombi jest uwidaczniony za pomocą właściwości Name kontrolki. Ponieważ kontrolka pola kombi znajduje się w widoku zawartości drzewa automatyzacji interfejsu użytkownika, kontrolka tekstu nie musi istnieć. Kontrolki tekstu mogą mieć elementy podrzędne w widoku zawartości, jeśli istnieje obiekt osadzony, taki jak hiperlink.
W poniższej tabeli wymieniono właściwości automatyzacji interfejsu użytkownika, których wartość lub definicja jest szczególnie istotna dla kontrolek tekstu. 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 | tekstu | |
| UIA_IsContentElementPropertyId | Zależy | Kontrolka tekstu jest zawartością, jeśli zawiera informacje, które nie są widoczne we właściwości Name innej kontrolki. |
| UIA_IsControlElementPropertyId | PRAWDZIWY | Kontrolka tekstu musi zawsze być kontrolką. |
| UIA_IsKeyboardFocusablePropertyId | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| UIA_LabeledByPropertyId | ZERO | Kontrolki tekstu nie mają statycznej etykiety tekstowej. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający typowi kontrolki text. Wartość domyślna to "text" dla en-US lub angielski (Stany Zjednoczone). |
| UIA_NamePropertyId | Zobacz uwagi. | Nazwa kontrolki tekstu może być wyświetlanym tekstem. Jeśli jednak kontrolka obsługuje również wzorzec Tekst, a tekst jest obszerny, nie używaj pełnej zawartości tekstowej jako wartości Nazwa. Zamiast tego podaj wartość Nazwa, która jest krótsza, pochodząca z innych właściwości kontrolki. |
W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi przez kontrolki tekstu. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie.
| Wzorzec kontrolki | Wsparcie | Notatki |
|---|---|---|
| IGridItemProvider | Zależy | Jeśli kontrolka tekstu znajduje się w kontrolce tabeli, wzorzec kontrolki GridItem musi być obsługiwany. |
| ITableItemProvider | Zależy | Jeśli kontrolka tekstu znajduje się w kontrolce tabeli, wzorzec kontrolki TableItem musi być obsługiwany. |
| ITextProvider | Zależy | Tekst powinien obsługiwać wzorzec kontrolki Text w celu zapewnienia lepszej dostępności; jednak nie jest to wymagane. Wzorzec kontrolki Tekst jest przydatny, gdy tekst ma styl sformatowany i atrybuty (na przykład kolor, pogrubienie i kursywa). |
| IValueProvider | Nigdy | Kontrolka tekstu nigdy nie obsługuje wzorca kontrolki Value. Jeśli tekst jest edytowalny, jest to typ kontrolki Edytuj. |
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika wymagane do obsługi kontrolek tekstu. 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_NamePropertyId zdarzenie zmienione właściwości. | |
| UIA_StructureChangedEventId | |
| UIA_Text_TextChangedEventId | Jeśli kontrolka obsługuje wzorzec kontrolki Text, musi obsługiwać to zdarzenie. |