Implementace vzoru ovládacích prvků hodnota pro automatizaci uživatelského rozhraní
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 představuje pokyny a konvence pro implementaci IValueProvider, včetně informací o událostech a vlastnostech. Odkazy na další odkazy jsou uvedeny na konci tématu.
Vzor ValuePattern ovládacího prvku slouží k podpoře ovládacích prvků, které mají vnitřní hodnotu, která nepřebírají rozsah a mohou být reprezentovány jako řetězec. Tento řetězec lze upravit v závislosti na ovládacím prvku a jeho nastavení. Příklady ovládacích prvků, které tento vzor implementují, najdete v tématu Mapování vzorů ovládacích prvků pro model UI Automation klienty.
Pokyny a konvence implementace
Při implementaci vzoru řízení hodnoty si všimněte následujících pokynů a konvencí:
- Ovládací prvky, jako ListItem jsou a TreeItem musí podporovat ValuePattern , pokud je hodnota některé z položek upravitelná bez ohledu na aktuální režim úprav ovládacího prvku. Nadřazený ovládací prvek musí také podporovat ValuePattern , pokud jsou podřízené položky upravitelné.
Příklad upravitelné položky seznamu
Jednořádkový ovládací prvky pro úpravy podporují programový přístup k jejich obsahu implementací IValueProvider. Víceřádkové ovládací prvky úprav však neimplementují IValueProvider; místo toho poskytují přístup ke svému obsahu implementací ITextProvider.
Chcete-li načíst textový obsah víceřádkového ovládacího prvku pro úpravy, musí ovládací prvek implementovat ITextProvider. ITextProvider Nepodporuje ale nastavení hodnoty ovládacího prvku.
IValueProvider nepodporuje načítání informací o formátování nebo hodnot podřetěžce. Implementujte ITextProvider v těchto scénářích.
IValueProvider musí být implementovány ovládacími prvky, jako je například ovládací prvek pro výběr barvy z Microsoft Wordu (znázorněno níže), který podporuje mapování řetězců mezi hodnotou barvy (například "žlutá") a ekvivalentní interní strukturou RGB.
Příklad mapování řetězců vzorníku barev
- Ovládací prvek by měl mít nastavenou IsEnabledProperty hodnotu a jeho IsReadOnlyProperty sadu
falsetruepřed povolením volání SetValue.
Požadované členy pro IValueProvider
Pro implementaci IValueProviderjsou vyžadovány následující vlastnosti a metody .
| Požadované členy | Typ členu | Notes |
|---|---|---|
| IsReadOnlyProperty | Vlastnost | Nic |
| ValueProperty | Vlastnost | Nic |
| SetValue | metoda | Nic |
Výjimky
Poskytovatelé musí vyvolat následující výjimky.
| Typ výjimky | Podmínka |
|---|---|
| InvalidOperationException | SetValue - Pokud jsou informace specifické pro národní prostředí předány ovládacímu prvku v nesprávném formátu, například nesprávně formátované datum. |
| ArgumentException | SetValue – Pokud nelze převést novou hodnotu z řetězce na formát, který ovládací prvek rozpozná. |
| ElementNotEnabledException | SetValue – Při pokusu o manipulaci s ovládacím prvku, který není povolen. |
Viz také
- Přehled vzorů ovládacích prvků pro automatizaci uživatelského rozhraní
- Podpora vzorů ovládacích prvků u zprostředkovatele automatizace uživatelského rozhraní
- Vzory ovládacích prvků automatizace uživatelského rozhraní pro klienty
- ValuePattern Insert Text Sample
- Přehled stromu automatizace uživatelského rozhraní
- Použití mezipaměti při automatizaci uživatelského rozhraní