Implementace vzoru ovládacích prvků hodnot automatizace 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 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 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 klienty automatizace uživatelského rozhraní.

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 jsou ListItem a TreeItem, musí podporovat ValuePattern, pokud je hodnota libovolné položky 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 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 hodnotu IsEnabledProperty na true a hodnotu IsReadOnlyProperty na false př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	Poznámky
IsReadOnlyProperty	Vlastnictví	Žádné
ValueProperty	Vlastnictví	Žádné
SetValue	Metoda	Žádné

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ů automatizace uživatelského rozhraní
• Podpora vzorů ovládacích prvků v poskytovateli automatizace uživatelského rozhraní
• Vzory ovládacích prvků automatizace uživatelského rozhraní pro klienty
• Ukázka vložení textu pro ValuePattern
• Přehled stromu automatizace uživatelského rozhraní
• Použití ukládání do mezipaměti v automatizaci uživatelského rozhraní