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 model UI Automation definované v System.Windows.Automation oboru názvů. Nejnovější informace o model UI Automation najdete v tématu Rozhraní API služby Windows Automation: model UI Automation.
Toto téma obsahuje informace o podpoře model UI Automation pro typ ovládacího prvku Popis. V model UI Automation je typ ovládacího prvku sadou podmínek, které musí ovládací prvek splňovat, aby bylo možné vlastnost použítControlTypeProperty. Podmínky zahrnují specifické pokyny pro strukturu stromové struktury model UI Automation, model UI Automation hodnoty vlastností a vzory ovládacích prvků.
Ovládací prvky popisku tlačítek jsou automaticky otevíraná okna, která obsahují text.
Následující části definují požadovanou model UI Automation stromovou strukturu, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku Popis. Požadavky na model UI Automation platí pro všechny ovládací prvky popisů nástrojů, ať už windows Presentation Foundation (WPF), Win32 nebo model Windows Forms.
Požadovaná struktura stromu model UI Automation
Následující tabulka znázorňuje zobrazení ovládacích prvků a zobrazení obsahu stromu model UI Automation, 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 model UI Automation naleznete v tématu model UI Automation Strom přehledu.
| Zobrazení ovládacího prvku | Zobrazení obsahu |
|---|---|
| Popisy tlačítek - Text (0 nebo více) - Obrázek (0 nebo více) |
Popisy tlačítek |
Ovládací prvky popisku tlačítek se zobrazí pouze v zobrazení obsahu model UI Automation stromu, pokud mohou přijímat fokus klávesnice. V opačném případě jsou všechny informace o tipu nástroje k dispozici z HelpTextProperty prvku model UI Automation, 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 model UI Automation
V následující tabulce jsou uvedeny vlastnosti model UI Automation, jejichž hodnota nebo definice jsou zvláště relevantní pro ovládací prvky popisů tlačítek. Další informace o model UI Automation vlastnosti naleznete v tématu model UI Automation Vlastnosti pro klienty.
| vlastnost model UI Automation | Hodnota | Notes |
|---|---|---|
| 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 součástí popisku nástroje, který ovládací prvek zavře. Některé tipy pro nástroje tuto schopnost nemají a nebudou mít kliknutelný 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 | Popisy tlačítek | 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 | True | Ovládací prvek popisku nástroje musí být vždy ovládací prvek. |
Požadované vzory ovládacích prvků model UI Automation
Následující tabulka uvádí model UI Automation vzory ovládacích prvků vyžadované ovládacími prvky popisů tlačítek. Další informace o vzorech ovládacích prvků najdete v tématu model UI Automation Přehled vzorů ovládacích prvků.
| Vzor ovládacího prvku | Technická podpora | Notes |
|---|---|---|
| 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 automaticky zavřít. |
| 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 model UI Automation
Ovládací prvky popisku ToolTipOpenedEvent tlačítek musí zvýšit, když se zobrazí na obrazovce. Událost bude obsahovat odkaz na model UI Automation prvek samotného popisku nástroje.
Následující tabulka uvádí model UI Automation události, které musí podporovat všechny ovládací prvky popisů nástrojů. Další informace oudálostch model UI Automation ch
| událost model UI Automation | Technická podpora | Notes |
|---|---|---|
| TextSelectionChangedEvent | Závisí | Nic |
| TextChangedEvent | Závisí | Nic |
| WindowClosedEvent | Závisí | Nic |
| WindowOpenedEvent | Závisí | Nic |
| ToolTipOpenedEvent | Požaduje se | Nic |
| ToolTipClosedEvent | Požaduje se | Nic |
| BoundingRectangleProperty událost změněná vlastností. | Požaduje se | Nic |
| IsOffscreenProperty událost změněná vlastností. | Požaduje se | Nic |
| IsEnabledProperty událost změněná vlastností. | Požaduje se | Nic |
| NameProperty událost změněná vlastností. | Požaduje se | Nic |
| WindowVisualStateProperty událost změněná vlastností. | Závisí | Nic |
| AutomationFocusChangedEvent | Požaduje se | Nic |
| StructureChangedEvent | Požaduje se | Nic |