ToolTip, typ kontrolki
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla ToolTip typu kontrolki. Kontrolki etykietki narzędzi to okna podręczne zawierające tekst.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce sterowania i zdarzenia dla typu kontrolki ToolTip. Wymagania automatyzacji interfejsu użytkownika mają zastosowanie do wszystkich kontrolek etykietek narzędzi, 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 etykietek narzędzi 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 etykietki narzędzi są wyświetlane tylko w widoku zawartości drzewa automatyzacji interfejsu użytkownika, jeśli mogą odbierać fokus klawiatury. W przeciwnym razie wszystkie informacje etykietki narzędzia są dostępne z IUIAutomationElement::CurrentHelpText (lub CachedHelpText) właściwości w elemencie, do którego odwołuje się etykietka narzędzia.
Etykietki narzędzi powinny pojawić się pod kontrolką, do której odwołują się informacje. Klienci muszą nasłuchiwać UIA_ToolTipOpenedEventId, aby zapewnić spójne uzyskiwanie informacji zawartych w etykietkach narzędzi.
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 ToolTip. 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. | Punkt możliwy do kliknięcia powinien być częścią etykietki narzędzia, która odrzuca kontrolkę. Niektóre etykietki narzędzi nie mają tej możliwości i nie będą miały punktu możliwego do kliknięcia. |
| UIA_ControlTypePropertyId | ToolTip | |
| UIA_IsContentElementPropertyId | Zależy | Jeśli kontrolka etykietki narzędzia może odbierać fokus klawiatury, musi być wyświetlana w widoku zawartości drzewa. Jeśli jest tylko tekstem, jest on dostępny jako właściwość IUIAutomationElement::CurrentHelpText (lub CachedHelpText) z kontrolki, która ją wywołała. |
| UIA_IsControlElementPropertyId | Prawdziwy | Kontrolka etykietki narzędzia 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 etykietki narzędzi są zawsze oznaczone etykietą własną zawartością. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający typowi kontrolki Etykietka narzędzia. Wartość domyślna to "tooltip" dla en-US lub angielski (Stany Zjednoczone). |
| UIA_NamePropertyId | Zobacz uwagi. | Nazwa kontrolki etykietki narzędzia to tekst wyświetlany w etykietce narzędzia. |
Wymagane wzorce kontrolek
W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi przez kontrolki etykietki narzędzi. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie.
| Wzorzec kontrolki | Wsparcie | Notatki |
|---|---|---|
| ITextProvider | Zależy | Aby uzyskać lepszą dostępność, kontrolka etykietki narzędzi może obsługiwać wzorzec kontrolki Text, chociaż nie jest to wymagane. Wzorzec kontrolki Tekst jest przydatny, gdy tekst ma styl sformatowany i atrybuty (na przykład kolor, pogrubienie i kursywa). |
| IWindowProvider | Zależy | Etykietki narzędzi, które można zamknąć, klikając element interfejsu użytkownika, musi obsługiwać wzorzec sterowania okna, aby można było je zamknąć automatycznie. |
Zdarzenia wymagane
Kontrolki etykietki narzędzi muszą zgłaszać zdarzenie UIA_ToolTipOpenedEventId po wyświetleniu ich na ekranie. Zdarzenie będzie zawierać odwołanie do elementu automatyzacji interfejsu użytkownika samej etykietki narzędzia.
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika wymagane do obsługi kontrolek etykietek narzędzi. 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_Text_TextChangedEventId | Jeśli kontrolka obsługuje wzorzec kontrolki Text, musi obsługiwać to zdarzenie. |
| UIA_ToolTipClosedEventId | |
| UIA_ToolTipOpenedEventId | |
| UIA_StructureChangedEventId | |
| UIA_Window_WindowClosedEventId | Jeśli kontrolka obsługuje wzorzec kontrolki Window, musi obsługiwać to zdarzenie. |
| UIA_Window_WindowOpenedEventId | Jeśli kontrolka obsługuje wzorzec kontrolki Window, musi obsługiwać to zdarzenie. |
| UIA_WindowWindowVisualStatePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki Window, musi obsługiwać to zdarzenie. |
Tematy pokrewne