Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku text
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 Text. 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ů.
Textové ovládací prvky jsou základní položka uživatelského rozhraní, která představuje část textu na obrazovce.
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 Text. Požadavky na model UI Automation platí pro všechny textové ovládací prvky, 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 model UI Automation stromu, který se týká ovládacích prvků textu, 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 |
|---|---|
| Text | Text (pokud obsah) |
Textový ovládací prvek lze použít samostatně jako popisek nebo jako statický text ve formuláři. Může být také obsažen v rámci struktury:
Listitem
Treeitem
Dataitem
Textové ovládací prvky nemusí být v zobrazení obsahu model UI Automation stromu, protože text se často zobrazuje prostřednictvím NameProperty jiného ovládacího prvku. Například text, který slouží k označení ovládacího prvku Pole se seznamem, je vystaven prostřednictvím hodnoty ovládacího prvku NameProperty . Protože ovládací prvek Pole se seznamem je v zobrazení obsahu model UI Automation strom, není nutné, aby tam byl textový ovládací prvek. Ovládací prvky textu mají vždy v zobrazení obsahu 0 podřízených položek.
Požadované vlastnosti model UI Automation
Následující tabulka uvádí model UI Automation vlastnosti, jejichž hodnota nebo definice jsou zvláště relevantní pro textové ovládací prvky. 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. | Podporuje se, pokud existuje ohraničující obdélník. Pokud ne každý bod uvnitř ohraničujícího obdélníku je možné kliknout a provést specializované testování hitů, pak přepsat a poskytnout 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 textového pruhu je vždy txt, který se zobrazí. |
| LabeledByProperty | Null |
Textové ovládací prvky nemají statický textový popisek. |
| ControlTypeProperty | Text | Tato hodnota je stejná pro všechny architektury uživatelského rozhraní. |
| LocalizedControlTypeProperty | "text" | Lokalizovaný řetězec odpovídající typu textového ovládacího prvku. |
| IsContentElementProperty | Závisí | Textový ovládací prvek bude obsah, pokud obsahuje informace, které nejsou vystaveny v nameProperty jiného ovládacího prvku. |
| IsControlElementProperty | True | Textový ovládací prvek musí být vždy ovládací prvek. |
Požadované vzory ovládacích prvků model UI Automation
V následující tabulce jsou uvedeny vzory ovládacích prvků model UI Automation, které musí ovládací prvky textu podporovat. 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 |
|---|---|---|
| IValueProvider | Nikdy | Text nikdy nepodporuje ValuePattern. Pokud je text upravitelný, jedná se o typ ovládacího prvku Upravit. |
| ITextProvider | Závisí | Text by měl podporovat vzor ovládacího prvku Text pro lepší přístupnost; není však vyžadováno. 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). Závisí na rozhraní. |
| ITableItemProvider | Závisí | Pokud je textový prvek obsažený v ovládacím prvku Table, musí být podporován. |
| IRangeValueProvider | Závisí | Pokud je textový prvek obsažený v ovládacím prvku tabulky, musí být podporován. |
Požadované události model UI Automation
Následující tabulka uvádí model UI Automation události, které musí být podporovány všemi textovými ovládacími prvky. Další informace oudálostch model UI Automation ch
| událost model UI Automation | Technická podpora | Notes |
|---|---|---|
| TextSelectionChangedEvent | Požaduje se | Nic |
| TextChangedEvent | 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 |
| ValueProperty událost změněná vlastností. | Nikdy | Nic |
| AutomationFocusChangedEvent | Požaduje se | Nic |
| StructureChangedEvent | Požaduje se | Nic |