Typ ovládacího prvku Popis
Toto téma obsahuje informace o podpoře microsoft UI Automation pro typ ovládacího prvku ToolTip. Ovládací prvky popisu jsou automaticky otevíraná okna, která obsahují text.
Následující části definují požadovanou strukturu stromu automatizace uživatelského rozhraní, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku Popis. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky popisu, ve kterých architektura uživatelského rozhraní nebo platforma integrují podporu automatizace uživatelského rozhraní pro typy ovládacích prvků a vzory ovládacích prvků.
Toto téma obsahuje následující části.
- typické stromové struktury
- relevantních vlastností
- požadované vzory ovládacích prvků
- požadovaných událostí
- související témata
Typická stromová struktura
Následující tabulka znázorňuje typické zobrazení ovládacího prvku a obsahu stromu automatizace uživatelského rozhraní, které se týká ovládacích prvků popisu a popisuje, co může být obsaženo v jednotlivých zobrazeních. Další informace o stromu automatizace uživatelského rozhraní naleznete v tématu přehled stromu automatizace uživatelského rozhraní.
| Zobrazení ovládacího prvku | Zobrazení obsahu |
|---|---|
|
|
Ovládací prvky popisu se zobrazí pouze v zobrazení obsahu stromu automatizace uživatelského rozhraní, pokud můžou přijímat fokus klávesnice. V opačném případě jsou všechny informace popisku k dispozici z vlastnosti IUIAutomationElement::CurrentHelpText (nebo CachedHelpText) prvku, na který popis odkazuje.
Popisy by se měly zobrazovat pod ovládacím prvku, na který odkazují jejich informace. Klienti musí naslouchat UIA_ToolTipOpenedEventId, aby zajistili, že konzistentně získávají informace obsažené v popisech.
Relevantní vlastnosti
Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště relevantní pro typ ovládacího prvku Popis. Další informace o vlastnostech automatizace uživatelského rozhraní naleznete v tématu Načítání vlastností z prvků automatizace uživatelského rozhraní.
| Vlastnost automatizace uživatelského rozhraní | Hodnota | Poznámky |
|---|---|---|
| UIA_AutomationIdPropertyId | Viz poznámky. | Hodnota této vlastnosti musí být jedinečná mezi všemi partnerskými prvky v nezpracovaného zobrazení stromu automatizace uživatelského rozhraní. |
| UIA_BoundingRectanglePropertyId | Viz poznámky. | Vnější obdélník, který obsahuje celý ovládací prvek. |
| UIA_ClickablePointPropertyId | Viz poznámky. | Kliknutím na bod by měl být součástí popisku, který ovládací prvek zavře. Některé popisy nemají tuto schopnost a nebudou mít klikatelný bod. |
| UIA_ControlTypePropertyId | popis | |
| UIA_IsContentElementPropertyId | Závisí | Pokud ovládací prvek popisu může přijímat fokus klávesnice, musí se zobrazit v zobrazení obsahu stromu. Je-li pouze text, je k dispozici jako IUIAutomationElement::CurrentHelpText (nebo CachedHelpText) vlastnost z ovládacího prvku, který ho vyvolal. |
| UIA_IsControlElementPropertyId | Pravdivý | Ovládací prvek popisu je vždy součástí zobrazení ovládacího prvku stromu automatizace uživatelského rozhraní. |
| UIA_IsKeyboardFocusablePropertyId | Viz poznámky. | Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat. |
| UIA_LabeledByPropertyId | NULA | Ovládací prvky popisu jsou vždy označené svým obsahem. |
| UIA_LocalizedControlTypePropertyId | Viz poznámky. | Lokalizovaný řetězec odpovídající typu ovládacího prvku Popis Výchozí hodnota je "popis" pro en-US nebo angličtinu (Spojené státy). |
| UIA_NamePropertyId | Viz poznámky. | Název ovládacího prvku popisku je text zobrazený v popisku. |
Požadované vzory ovládacích prvků
Následující tabulka uvádí vzory ovládacích prvků automatizace uživatelského rozhraní, které jsou potřeba k podpoře ovládacími prvky popisu. Další informace o vzorech ovládacích prvků najdete v tématu přehled vzorů ovládacích prvků automatizace uživatelského rozhraní.
| Vzor ovládacího prvku | Podpora | Poznámky |
|---|---|---|
| ITextProvider | Závisí | Pro lepší přístupnost může ovládací prvek popisu podporovat vzor ovládacího prvku Text, i když to není povinné. Vzor ovládacího prvku Text je užitečný, pokud má text formátovaný styl a atributy (například barvu, tučné písmo a kurzívu). |
| IWindowProvider | Závisí | Popisy, které lze zavřít kliknutím na položku uživatelského rozhraní, musí podporovat Okno řídicí vzor, aby bylo možné je automaticky zavřít. |
Požadované události
Ovládací prvky popisu musí vyvolat UIA_ToolTipOpenedEventId událost, když se zobrazí na obrazovce. Událost bude obsahovat odkaz na prvek Automatizace uživatelského rozhraní samotného popisu.
Následující tabulka uvádí události automatizace uživatelského rozhraní, které ovládací prvky popisu vyžadují pro podporu. Další informace o událostech najdete v tématu Přehled událostí automatizace uživatelského rozhraní.
| Událost automatizace uživatelského rozhraní | Poznámky |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId událost změněnou vlastností. | |
| UIA_IsEnabledPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vlastnost IsEnabled, musí tuto událost podporovat. |
| UIA_IsOffscreenPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vlastnost IsOffscreen, musí tuto událost podporovat. |
| UIA_NamePropertyId událost změněnou vlastností. | |
| UIA_Text_TextChangedEventId | Pokud ovládací prvek podporuje vzor ovládacího prvku Text, musí tuto událost podporovat. |
| UIA_ToolTipClosedEventId | |
| UIA_ToolTipOpenedEventId | |
| UIA_StructureChangedEventId | |
| UIA_Window_WindowClosedEventId | Pokud ovládací prvek podporuje vzor ovládacího prvku Window, musí tuto událost podporovat. |
| UIA_Window_WindowOpenedEventId | Pokud ovládací prvek podporuje vzor ovládacího prvku Window, musí tuto událost podporovat. |
| UIA_WindowWindowVisualStatePropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vzor ovládacího prvku Window, musí tuto událost podporovat. |
Související témata