Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku úprav
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 Upravit. 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 pro úpravy umožňují uživateli zobrazit a upravit jednoduchý řádek textu bez podpory formátování.
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 Upravit. Požadavky na model UI Automation platí pro všechny ovládací prvky pro úpravy, 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á úprav ovládacích prvků, a popisuje, co může být obsaženo v jednotlivých zobrazeních. Další informace o stromu model UI Automation najdete v tématu model UI Automation Stromový přehled.
| Zobrazení ovládacího prvku | Zobrazení obsahu |
|---|---|
| Upravit | Upravit |
Ovládací prvky, které implementují typ ovládacího prvku Upravit, budou mít vždy nulové posuvníky v zobrazení ovládacího prvku model UI Automation strom, protože se jedná o jednořádkové řízení. Jeden řádek textu se může zalomit v některých scénářích rozložení. Typ ovládacího prvku Upravit je nejvhodnější pro uchovávání malých objemů upravitelných nebo vybratelných textů.
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 úpravy ovládacích prvků. 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. | Ovládací prvek pro úpravy musí mít kliknutelný bod, který dává vstupní fokus na část ovládacího prvku pro úpravy, když uživatel klikne na myš tam. |
| 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 pro úpravy se obvykle generuje ze statického textového popisku. Pokud není popisek statického textu, musí vývojář aplikace přiřadit hodnotu Name vlastnosti. Vlastnost Name by nikdy neměla obsahovat textový obsah ovládacího prvku pro úpravy. |
| LabeledByProperty | Viz poznámky. | Pokud je k ovládacímu prvku přidružený statický textový popisek, musí tato vlastnost vystavit odkaz na tento ovládací prvek. Pokud je textový ovládací prvek dílčí součástí jiného ovládacího prvku, nebude mít nastavenou LabeledBy vlastnost. |
| ControlTypeProperty | Upravit | Tato hodnota je stejná pro všechny architektury uživatelského rozhraní. |
| LocalizedControlTypeProperty | "edit" | Lokalizovaný řetězec odpovídající typu ovládacího prvku Upravit |
| IsContentElementProperty | True | Ovládací prvek pro úpravy je vždy součástí zobrazení obsahu model UI Automation stromu. |
| IsControlElementProperty | True | Ovládací prvek pro úpravy je vždy součástí zobrazení ovládacího prvku stromu model UI Automation. |
| IsPasswordProperty | Viz poznámky. | U ovládacích prvků pro úpravy, které obsahují hesla, musí být nastavená na true. Pokud ovládací prvek pro úpravy obsahuje obsah hesla, může tuto vlastnost použít čtečka obrazovky k určení, zda mají být stisknutí klávesy přečteny, když je uživatel zadá. |
Požadované vzory a vlastnosti ovládacích prvků model UI Automation
V následující tabulce jsou uvedeny vzory ovládacích prvků, které jsou potřeba pro podporu všech ovládacích prvků pro úpravy. Další informace o vzorech ovládacích prvků najdete v tématu model UI Automation Přehled vzorů ovládacích prvků.
| Vlastnost vzoru ovládacího prvku nebo vzoru ovládacího prvku | Podpora/hodnota | Notes |
|---|---|---|
| ITextProvider | Závisí | Ovládací prvky pro úpravy by měly podporovat vzor ovládacího prvku Text, protože podrobné textové informace by měly být vždy k dispozici pro klienty. |
| IValueProvider | Závisí | Všechny ovládací prvky pro úpravy, které přebírají řetězec, musí vystavit vzor Hodnoty. |
| IsReadOnly | Viz poznámky. | Tato vlastnost musí být nastavena tak, aby označí, zda ovládací prvek může mít nastavenou hodnotu programově nebo zda je možné upravit uživatelem. |
| Value | Viz poznámky. | Tato vlastnost vrátí textový obsah ovládacího prvku pro úpravy. Pokud je nastavena na IsPasswordPropertytrue, tato vlastnost musí vyvolat InvalidOperationException při vyžádání. |
| IRangeValueProvider | Závisí | Všechny ovládací prvky pro úpravy, které přebírají číselný rozsah, musí vystavit vzor ovládacího prvku Hodnota rozsahu. |
| Minimum | Viz poznámky. | Tato vlastnost musí být nejmenší hodnotou, na kterou lze nastavit obsah ovládacího prvku pro úpravy. |
| Maximum | Viz poznámky. | Tato vlastnost musí být největší hodnotou, na kterou lze nastavit obsah ovládacího prvku pro úpravy. |
| SmallChange | Viz poznámky. | Tato vlastnost musí uvádět počet desetinných míst, na které lze hodnotu nastavit. Pokud úpravy přebírají jenom celá čísla, SmallChangeProperty musí být 1. Pokud úpravy mají rozsah od 1,0 do 2,0, SmallChangeProperty musí být 0,1. Pokud ovládací prvek pro úpravy přebírá rozsah od 1,00 do 2,00, SmallChangeProperty musí být 0,001. |
| LargeChange | Null |
Tato vlastnost nemusí být vystavena v ovládacím prvku pro úpravy. |
| Value | Viz poznámky. | Tato vlastnost označuje číselný obsah ovládacího prvku pro úpravy. Pokud je přesnější hodnota nastavena klientem model UI Automation v rozsahech zadaných v Minimum oblasti a Maximum vlastnosti, vlastnost Value se automaticky zaokrouhlí na nejbližší přijatou hodnotu. |
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 ovládacími prvky pro úpravy. Další informace oudálostch model UI Automation ch
| událost model UI Automation | Technická podpora | Notes |
|---|---|---|
| InvalidatedEvent | Požaduje se | Nic |
| 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í. | Závisí | Nic |
| HorizontallyScrollableProperty událost změněná vlastností. | Nikdy | Nic |
| HorizontalScrollPercentProperty událost změněná vlastností. | Nikdy | Nic |
| HorizontalViewSizeProperty událost změněná vlastností. | Nikdy | Nic |
| VerticalScrollPercentProperty událost změněná vlastností. | Nikdy | Nic |
| VerticallyScrollableProperty událost změněná vlastností. | Nikdy | Nic |
| VerticalViewSizeProperty událost změněná vlastností. | Nikdy | Nic |
| ValueProperty událost změněná vlastností. | Závisí | Pokud ovládací prvek podporuje vzor ovládacího prvku Hodnota rozsahu, musí tuto událost podporovat. |
| AutomationFocusChangedEvent | Požaduje se | Nic |
| StructureChangedEvent | Požaduje se | Nic |