Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku ToolTip

Poznámka:

Tato dokumentace je určená pro vývojáře rozhraní .NET Framework, kteří chtějí používat spravované třídy automatizace uživatelského rozhraní definované v oboru názvů System.Windows.Automation. Nejnovější informace o automatizaci uživatelského rozhraní najdete v tématu rozhraní API služby Windows Automation: Automatizace uživatelského rozhraní.

Toto téma obsahuje informace o podpoře UI Automation pro typ ovládacího prvku ToolTip. V automatizaci uživatelského rozhraní je typ ovládacího prvku sadou podmínek, které musí ovládací prvek splnit, aby bylo možné vlastnost použít ControlTypeProperty . Podmínky zahrnují specifické pokyny pro strukturu stromu automatizace uživatelského rozhraní, hodnoty vlastností automatizace uživatelského rozhraní a vzory ovládacích prvků.

Ovládací prvky nápovědy jsou automaticky otevíraná okna, která obsahují text.

Následující části definují požadovanou strukturu stromu automatizace, vlastnosti, ovládací vzory a události pro typ ovládacího prvku ToolTip. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky popisů tlačítek, ať už windows Presentation Foundation (WPF), Win32 nebo Windows Forms.

Požadovaná struktura stromu automatizace uživatelského rozhraní

Následující tabulka znázorňuje zobrazení ovládacích prvků a zobrazení obsahu stromu automatizace uživatelského rozhraní, které se týká ovládacích prvků popisů tlačítek, a popisuje, co může být obsaženo v jednotlivých zobrazeních. Další informace o stromu automatizace uživatelského rozhraní najdete v tématu Přehled stromu automatizace uživatelského rozhraní.

Zobrazení ovládacího prvku	Zobrazení obsahu
Nápověda - Text (0 nebo více) - Obrázek (0 nebo více)	Nápověda

Ovládací prvky popisku tlačítek 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 popisu nástroje k dispozici z HelpTextProperty prvku automatizace uživatelského rozhraní, na který odkazuje popis.

Popisy tlačítek by se měly zobrazovat pod ovládacím prvku, na který odkazují jejich informace. Klienti musí naslouchat, ToolTipOpenedEvent aby zajistili, že konzistentně získávají informace obsažené v popisech nástrojů.

Požadované vlastnosti automatizace uživatelského rozhraní

V následující tabulce jsou uvedeny vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště relevantní pro ovládací prvky popisů tlačítek. Další informace o vlastnostech automatizace uživatelského rozhraní naleznete v tématu Vlastnosti automatizace uživatelského rozhraní pro klienty.

Vlastnost automatizace uživatelského rozhraní	Hodnota	Poznámky
AutomationIdProperty	Viz poznámky.	Hodnota této vlastnosti musí být jedinečná pro všechny ovládací prvky v aplikaci.
BoundingRectangleProperty	Viz poznámky.	Vnější obdélník, který obsahuje celý ovládací prvek.
ClickablePointProperty	Viz poznámky.	Kliknutelný bod by měl být částí popisku nástroje, která ovládací prvek zavře. Některé nápovědy u nástrojů nemají tuto schopnost a nebudou mít klikací bod.
IsKeyboardFocusableProperty	Viz poznámky.	Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat.
NameProperty	Viz poznámky.	Název ovládacího prvku popisku nástroje je text zobrazený v popisku.
LabeledByProperty	Null	Ovládací prvky popisku tlačítek jsou vždy označené svým obsahem.
ControlTypeProperty	Nápověda	Tato hodnota je stejná pro všechny architektury uživatelského rozhraní.
LocalizedControlTypeProperty	"popisek"	Lokalizovaný řetězec odpovídající typu ovládacího prvku Popis
IsContentElementProperty	Závisí	Pokud ovládací prvek popisku nástroje může přijímat fokus klávesnice, musí být ve stromovém zobrazení. Je-li pouze text, je k dispozici jako HelpTextProperty z ovládacího prvku, který ho vyvolal.
IsControlElementProperty	Pravdivé	Ovládací prvek popisku nástroje musí být vždy ovládací prvek.

Požadované vzory ovládacích prvků automatizace uživatelského rozhraní

V následující tabulce jsou uvedeny vzory ovládacích prvků automatizace uživatelského rozhraní, které musí podporovat ovládací prvky popisků nástrojů. 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
IWindowProvider	Závisí	Popisy nástrojů, které lze zavřít kliknutím na položku uživatelského rozhraní, musí podporovat WindowPattern, aby se mohly zavírat automaticky.
ITextProvider	Závisí	Pro lepší přístupnost může ovládací prvek popisku nástroje 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).

Požadované události automatizace uživatelského rozhraní

Ovládací prvky nápovědy musí vyvolat ToolTipOpenedEvent ve chvíli, kdy se objeví na obrazovce. Událost bude obsahovat odkaz na prvek automatizace uživatelského rozhraní samotného tipu nástroje.

Následující tabulka uvádí události automatizace rozhraní UI, které musí podporovat všechny ovládací prvky tooltipů. Další informace o událostech naleznete v tématu Přehled událostí automatizace uživatelského rozhraní.

Událost automatizace uživatelského rozhraní	Podpora	Poznámky
TextSelectionChangedEvent	Závisí	Žádné
TextChangedEvent	Závisí	Žádné
WindowClosedEvent	Závisí	Žádné
WindowOpenedEvent	Závisí	Žádné
ToolTipOpenedEvent	Povinné	Žádné
ToolTipClosedEvent	Povinné	Žádné
BoundingRectangleProperty událost změny vlastnosti.	Povinné	Žádné
IsOffscreenProperty událost změny vlastnosti.	Povinné	Žádné
IsEnabledProperty událost změny vlastnosti.	Povinné	Žádné
NameProperty událost změny vlastnosti.	Povinné	Žádné
WindowVisualStateProperty událost změny vlastnosti.	Závisí	Žádné
AutomationFocusChangedEvent	Povinné	Žádné
StructureChangedEvent	Povinné	Žádné

Viz také

• ToolTip
• Přehled typů ovládacích prvků automatizace uživatelského rozhraní
• Přehled automatizace uživatelského rozhraní