Megosztás a következőn keresztül:

A felhasználói felület automatizálási értékvezérlési mintájának implementálása

Megjegyzés:

Ez a dokumentáció azoknak a .NET-keretrendszer-fejlesztőknek készült, akik a System.Windows.Automation névtérben definiált felügyelt felhasználói felületi Automation-osztályokat szeretnék használni. A felhasználói felület automatizálásával kapcsolatos legfrissebb információkért lásd Windows Automation API: UI Automation.

Ez a témakör a megvalósításra IValueProvidervonatkozó irányelveket és konvenciókat ismerteti, beleértve az eseményekre és tulajdonságokra vonatkozó információkat is. A további hivatkozásokra mutató hivatkozások a témakör végén jelennek meg.

A ValuePattern vezérlőminta olyan vezérlők támogatására szolgál, amelyek belső értéke nem terjed ki egy tartományra, és sztringként jeleníthető meg. Ez a sztring a vezérlőtől és a beállításoktól függően szerkeszthető. Azokat a vezérlő példákat, amelyek ezt a mintát valósítják meg, lásd: Vezérlőminta-megfeleltetés a felhasználói felület automatizálása során.

Végrehajtási irányelvek és egyezmények

Az értékkövetési minta megvalósításakor vegye figyelembe a következő irányelveket és konvenciókat:

  • Az olyan vezérlőknek, mint például ListItem és TreeItem, támogatniuk kell a ValuePattern-t, ha az elemek bármelyikének értéke szerkeszthető, függetlenül a vezérlő aktuális szerkesztési módjától. A szülő vezérlőelemnek akkor is támogatnia ValuePattern kell, ha a gyermekelemek szerkeszthetők.

Szerkeszthető listaelem. Példa szerkeszthető listaelemre

  • Az egysoros szerkesztési vezérlők programozott hozzáférést támogatnak a tartalmukhoz az IValueProvider implementálásával. A többsoros szerkesztési vezérlők azonban nem implementálnak IValueProvider; ehelyett a implementálással ITextProviderbiztosítják a tartalomhoz való hozzáférést.

  • A többsoros szerkesztési vezérlő szöveges tartalmának lekéréséhez a vezérlőnek implementálnia ITextProviderkell. A ITextProvider vezérlőelemek értékének beállítását azonban nem támogatja.

  • IValueProvider nem támogatja a formázási információk vagy az összevonási értékek lekérését. Valósítsa meg ITextProvider ezekben a forgatókönyvekben.

  • IValueProvider Olyan vezérlőkkel kell implementálnia, mint a Microsoft Word Színválasztó kijelölési vezérlője (alább látható), amely támogatja a színértékek (például "sárga") és az azzal egyenértékű belső RGB-struktúra közötti sztringleképezést.

Sárga kiemelésű színválasztó. Példa a színminta sztringleképezésére

Az IValueProvider szükséges tagjai

A megvalósításhoz IValueProvidera következő tulajdonságokra és metódusokra van szükség.

Kötelező tagok Tagtípus Jegyzetek
IsReadOnlyProperty Ingatlan Egyik sem
ValueProperty Ingatlan Egyik sem
SetValue Metódus Egyik sem

Kivételek

A szolgáltatóknak a következő kivételeket kell megadniuk.

Kivétel típusa Állapot
InvalidOperationException SetValue

- Ha a területi beállításokra vonatkozó információkat helytelen formátumban, például helytelenül formázott dátumként ad át egy vezérlőelemnek.
ArgumentException SetValue

– Ha egy új érték nem konvertálható sztringből olyan formátumba, amelyet a vezérlő felismer.
ElementNotEnabledException SetValue

- Ha olyan vezérlőt próbálnak manipulálni, amely nincs engedélyezve.

Lásd még

  • Last updated on