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 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 automatizace uživatelského rozhraní pro typ ovládacího prvku Text. 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ů.

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 stromovou strukturu automatizace uživatelského rozhraní, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku Text. Požadavky na automatizaci uživatelského rozhraní platí pro všechny textové ovládací prvky, 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á textových ovládacích prvků, 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
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:

• Položka seznamu

• TreeItem

• DataItem

Textové ovládací prvky nemusí být v zobrazení obsahu stromu automatizace uživatelského rozhraní, 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 kombinovaného boxu, je přenášen prostřednictvím hodnoty ovládacího prvku NameProperty. Protože ovládací prvek Kombinované pole je v zobrazení obsahu v hierarchii automatizace UI, není nutné, aby tam byl textový ovládací prvek. Textové ovládací prvky v zobrazení obsahu mají vždy 0 dětí.

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

Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště relevantní pro textové ovládací prvky. 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.	Podporuje se, pokud existuje ohraničující obdélník. Pokud není každý bod uvnitř ohraničujícího obdélníku kliknutelný a provádíte specializované testování zásahů, můžete 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 text, který zobrazuje.
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 spokojený, pokud obsahuje informace, které nejsou vystaveny ve VlastnostJména jiného ovládacího prvku.
IsControlElementProperty	Pravdivé	Textový ovládací prvek musí být vždy ovládací prvek.

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

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ích prvků textu. 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
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 automatizace uživatelského rozhraní

Následující tabulka uvádí události automatizace uživatelského rozhraní, které musí podporovat všechny textové ovládací prvky. 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	Povinné	Žádné
TextChangedEvent	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é
ValueProperty událost změny vlastnosti.	Nikdy	Žádné
AutomationFocusChangedEvent	Povinné	Žádné
StructureChangedEvent	Povinné	Žádné

Viz také

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