Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
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 Upravit. 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 pro úpravy umožňují uživateli zobrazit a upravit jednoduchý řádek textu bez podpory formátování.
Následující části definují požadovanou strukturu stromu automatizace uživatelského rozhraní, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku Upravit. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky pro úpravy, 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á úprav 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í naleznete v tématu přehled stromu automatizace uživatelského rozhraní.
| 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 stromu automatizace uživatelského rozhraní, 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 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 úpravy ovládacích prvků. 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. | 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 neexistuje statický textový popisek, musí vývojář aplikace přiřadit hodnotu vlastnosti pro Name. 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 | upravit | Lokalizovaný řetězec odpovídající typu ovládacího prvku Upravit |
| IsContentElementProperty | Pravdivé | Ovládací prvek pro úpravy je vždy součástí zobrazení obsahu stromu automatizace uživatelského rozhraní. |
| IsControlElementProperty | Pravdivé | Ovládací prvek pro úpravy je vždy součástí zobrazení ovládacího prvku stromu Automatizace uživatelského rozhraní. |
| 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ů automatizace uživatelského rozhraní
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ů naleznete v tématu Přehled vzorů ovládacích prvků automatizace uživatelského rozhraní.
| Vzor ovládacího prvku / Vlastnost vzoru ovládacího prvku | Podpora/hodnota | Poznámky |
|---|---|---|
| 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í poskytovat 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 IsPasswordProperty nastavena na true, tato vlastnost musí při vyžádání vyvolat InvalidOperationException. |
| 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 automatizace uživatelského rozhraní v rozsahech zadaných v Minimum oblasti a Maximum vlastnosti, bude vlastnost Value automaticky zaokrouhlena na nejbližší přijatou hodnotu. |
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 ovládací prvky pro úpravy. 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 |
|---|---|---|
| InvalidatedEvent | Povinné | Žádné |
| 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. | Závisí | Žádné |
| HorizontallyScrollableProperty událost změny vlastnosti. | Nikdy | Žádné |
| HorizontalScrollPercentProperty událost změny vlastnosti. | Nikdy | Žádné |
| HorizontalViewSizeProperty událost změny vlastnosti. | Nikdy | Žádné |
| VerticalScrollPercentProperty událost změny vlastnosti. | Nikdy | Žádné |
| VerticallyScrollableProperty událost změny vlastnosti. | Nikdy | Žádné |
| VerticalViewSizeProperty událost změny vlastnosti. | Nikdy | Žádné |
| ValueProperty událost změny vlastnosti. | Závisí | Pokud ovládací prvek podporuje vzor ovládání hodnoty rozsahu, musí podporovat tuto událost. |
| AutomationFocusChangedEvent | Povinné | Žádné |
| StructureChangedEvent | Povinné | Žádné |
Viz také
- Edit
- Přehled typů ovládacích prvků automatizace uživatelského rozhraní
- Přehled automatizace uživatelského rozhraní