Upravit typ ovládacího prvku
Toto téma obsahuje informace o podpoře microsoft UI Automation pro typ ovládacího prvku Upravit.
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 pro úpravy. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky pro úpravy, ve kterých architektura uživatelského rozhraní nebo platforma integruje podporu automatizace uživatelského rozhraní pro typy ovládacích prvků a vzory ovládacích prvků.
Toto téma obsahuje následující části.
- typické stromové struktury
- relevantních vlastností
- požadované vzory ovládacích prvků
- požadovaných událostí
- poznámky
- související témata
Typická stromová struktura
Následující tabulka znázorňuje typické zobrazení ovládacího prvku a 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 |
|---|---|
|
|
Ovládací prvky, které implementují typ ovládacího prvku Upravit, budou mít v zobrazení ovládacího prvku stromu automatizace uživatelského rozhraní vždy nula posuvníků, 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 Edit je určen pouze pro malé množství textu.
Relevantní vlastnosti
Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště relevantní pro ovládací prvky pro úpravy. Další informace o vlastnostech automatizace uživatelského rozhraní naleznete v tématu Načítání vlastností z prvků automatizace uživatelského rozhraní.
| Vlastnost automatizace uživatelského rozhraní | Hodnota | Poznámky |
|---|---|---|
| UIA_AutomationIdPropertyId | Viz poznámky. | Hodnota této vlastnosti musí být jedinečná mezi všemi partnerskými prvky v nezpracovaného zobrazení stromu automatizace uživatelského rozhraní. |
| UIA_BoundingRectanglePropertyId | Viz poznámky. | Vnější obdélník, který obsahuje celý ovládací prvek. |
| UIA_ClickablePointPropertyId | 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. |
| UIA_ControlTypePropertyId | Upravit | |
| UIA_IsContentElementPropertyId | TRUE | Ovládací prvek pro úpravy je vždy součástí zobrazení obsahu stromu automatizace uživatelského rozhraní. |
| UIA_IsControlElementPropertyId | TRUE | Ovládací prvek pro úpravy je vždy součástí zobrazení ovládacího prvku stromu Automatizace uživatelského rozhraní. |
| UIA_IsKeyboardFocusablePropertyId | Viz poznámky. | Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat. |
| UIA_IsPasswordPropertyId | 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á. |
| UIA_LabeledByPropertyId | 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 vlastnost LabeledBy. |
| UIA_LocalizedControlTypePropertyId | Viz poznámky. | Lokalizovaný řetězec odpovídající typu ovládacího prvku Edit. Výchozí hodnota je "edit" pro en-US nebo angličtinu (Spojené státy). |
| UIA_NamePropertyId | 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 vlastnosti Název. Vlastnost Název by nikdy neměla obsahovat textový obsah ovládacího prvku pro úpravy. |
Požadované vzory ovládacích prvků
Následující tabulka uvádí vzory ovládacích prvků automatizace uživatelského rozhraní, které je potřeba podporovat pomocí ovládacích prvků pro úpravy. Další informace o vzorech ovládacích prvků najdete v tématu přehled vzorů ovládacích prvků automatizace uživatelského rozhraní.
| Vlastnost vzoru ovládacího prvku nebo vzoru | Podpora/hodnota | Poznámky |
|---|---|---|
| IRangeValueProvider | Závisí | Všechny ovládací prvky pro úpravy, které přebírají číselný rozsah, musí zveřejnit RangeValue vzor ovládacího prvku. |
| minimální | Viz poznámky. | Tato vlastnost musí být nejmenší hodnotou, na kterou lze nastavit obsah ovládacího prvku pro úpravy. |
| maximální | 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 ovládací prvek pro úpravy přebírá pouze celá čísla, hodnota vlastnosti SmallChange musí být 1. Pokud ovládací prvek pro úpravy přebírá rozsah od 1,0 do 2.0, pak hodnota vlastnosti SmallChange musí být 0,1. Pokud ovládací prvek pro úpravy přebírá rozsah od 1,00 do 2,00, pak hodnota vlastnosti SmallChange musí být 0,001. |
| LargeChange | null | Tato vlastnost nemusí být vystavena v ovládacím prvku pro úpravy. |
| hodnoty | 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 Minimální a Maximální vlastnosti, vlastnost Hodnota se automaticky zaokrouhlí na nejbližší přijatou hodnotu. |
| ITextProvider | Požadovaný | Všechny ovládací prvky úprav musí podporovat vzor ovládacích prvků Text, protože podrobné informace musí být vždy k dispozici pro klienty technologie usnadnění. |
| IValueProvider | Závisí | Všechny ovládací prvky pro úpravy, které přebírají řetězec, musí zveřejnit hodnotu vzor ovládacího prvku. |
| IsReadOnly | Viz poznámky. | Tato vlastnost musí být nastavena tak, aby indikovala, zda ovládací prvek může mít nastavenou hodnotu programově, nebo který může uživatel upravit. |
| hodnoty | Viz poznámky. | Tato vlastnost obsahuje textový obsah ovládacího prvku pro úpravy. Pokud je vlastnost UIA_IsPasswordPropertyId nastavena na hodnotu TRUE, dotazování na vlastnost Hodnota musí vrátit chybu. |
Požadované události
Následující tabulka uvádí události automatizace uživatelského rozhraní, které upravují ovládací prvky, které jsou potřeba k podpoře. Další informace o událostech najdete v tématu Přehled událostí automatizace uživatelského rozhraní.
| Událost automatizace uživatelského rozhraní | Poznámky |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId událost změněnou vlastností. | |
| UIA_IsEnabledPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vlastnost IsEnabled, musí tuto událost podporovat. |
| UIA_IsOffscreenPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vlastnost IsOffscreen, musí tuto událost podporovat. |
| UIA_NamePropertyId událost změněnou vlastností. | |
| UIA_RangeValueValuePropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje RangeValue vzor ovládacího prvku, musí tuto událost podporovat. |
| UIA_ScrollHorizontallyScrollablePropertyId událost změněnou vlastností. | Ovládací prvek pro úpravy nikdy nepodporuje vzor ovládacích prvků Scroll. |
| UIA_ScrollHorizontalScrollPercentPropertyId událost změněnou vlastností. | Ovládací prvek pro úpravy nikdy nepodporuje vzor ovládacích prvků Scroll. |
| UIA_ScrollHorizontalViewSizePropertyId událost změněnou vlastností. | Ovládací prvek pro úpravy nikdy nepodporuje vzor ovládacích prvků Scroll. |
| UIA_ScrollVerticallyScrollablePropertyId událost změněnou vlastností. | Ovládací prvek pro úpravy nikdy nepodporuje vzor ovládacích prvků Scroll. |
| UIA_ScrollVerticalScrollPercentPropertyId událost změněnou vlastností. | Ovládací prvek pro úpravy nikdy nepodporuje vzor ovládacích prvků Scroll. |
| UIA_ScrollVerticalViewSizePropertyId událost změněnou vlastností. | Ovládací prvek pro úpravy nikdy nepodporuje vzor ovládacích prvků Scroll. |
| UIA_StructureChangedEventId | |
| UIA_Text_TextChangedEventId | Pokud ovládací prvek podporuje vzor ovládacího prvku Text, musí tuto událost podporovat. |
| UIA_Text_TextSelectionChangedEventId | Pokud ovládací prvek podporuje vzor ovládacího prvku Text, musí tuto událost podporovat. |
| UIA_ValueValuePropertyId událost změněnou vlastností . | Pokud ovládací prvek podporuje vzor ovládacího prvku Hodnota, musí tuto událost podporovat. |
Poznámky
Ovládací prvek pro úpravy lze použít jako textové pole jen pro čtení, které nepodporuje výběr nebo úpravy textu. Takový ovládací prvek pro úpravy se chová jako objekt pole, který má určitý název a hodnotu.
Pokud ovládací prvek pro úpravy obsahuje zástupný text (například banner nápovědy), měl by se text použít jako vlastnost HelpText, pokud ho uživatel nemůže upravit a pak ho znovu použít jako zástupný text. Například panel Adresa aplikace Windows Internet Explorer obsahuje při otevření nové karty text about:Tabs. Není to nápovědy, protože se jedná o programovou adresu, kterou může uživatel použít nebo upravit.
Související témata