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

A felhasználói felület automatizálásának kiválasztásvezé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 ISelectionProvidervonatkozó 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 SelectionPattern vezérlőminta a választható gyermekelemek gyűjteményéhez tárolóként működő vezérlők támogatására szolgál. Ennek az elemnek a gyermekeinek implementálniuk ISelectionItemProviderkell . A vezérlőmintát megvalósító vezérlők példáiért lásd: Vezérlőminta-megfeleltetés a felhasználói felület automatizálási ügyfelei számára.

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

A kijelölés-vezérlési minta megvalósításakor vegye figyelembe a következő irányelveket és konvenciókat:

  • Azok a vezérlők, amelyek ISelectionProvider lehetővé teszik egy vagy több gyermekelem kijelölését. A lista, a listanézet és a fanézet például több kijelölést támogat, míg a kombinált lista, a csúszka és a választógomb-csoport támogatja az önálló kijelölést.

  • Azoknak a vezérlőknek, amelyek minimális, maximális és folyamatos tartományúak, mint például a Hangerő csúszka vezérlő, a IRangeValueProvider-t kell implementálniuk a ISelectionProvider helyett.

  • Az olyan gyermekvezérlőket kezelő egy választást megengedő vezérlőknek, mint például a IRawElementProviderFragmentRoot csúszka a Megjelenítési tulajdonságok párbeszédpanelen vagy a Microsoft Word színválasztó vezérlője (az alábbi ábrán látható), implementálniuk kell ; gyermekeiknek pedig mind az ISelectionProvider és IRawElementProviderFragment implementálása szükséges.

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

  • A menük nem támogatják a SelectionPattern-t. Ha olyan menüelemekkel dolgozik, amelyek grafikus és szöveges elemeket is tartalmaznak (például a Microsoft Outlook Nézet menüjének Előnézet panelelemei), és állapotot kell közvetítenie, implementálnia IToggleProviderkell.

Az ISelectionProviderhez szükséges tagok

A felülethez ISelectionProvider a következő tulajdonságok, metódusok és események szükségesek.

Kötelező tagok típus Jegyzetek
CanSelectMultiple Ingatlan Támogatnia kell a tulajdonságváltozás eseményeit a AddAutomationPropertyChangedEventHandler és a RemoveAutomationPropertyChangedEventHandler használatával.
IsSelectionRequired Ingatlan Támogatnia kell a tulajdonságváltozás eseményeit a AddAutomationPropertyChangedEventHandler és a RemoveAutomationPropertyChangedEventHandler használatával.
GetSelection Metódus Egyik sem
InvalidatedEvent Esemény Akkor merül fel, ha a tárolóban lévő kijelölés jelentősen megváltozott, és több hozzáadási és eltávolítási esemény küldésére van szükség, mint amit az InvalidateLimit állandó megenged.

A IsSelectionRequired és CanSelectMultiple tulajdonságok lehetnek dinamikusak. Előfordulhat például, hogy egy vezérlő kezdeti állapota nem tartalmaz alapértelmezés szerint kijelölt elemeket, ami azt jelzi, hogy IsSelectionRequired az false. Azután, hogy egy elem ki lett jelölve, a vezérlőelemnek mindig legalább egy elem maradjon kijelölve. Hasonlóképpen, ritkán előfordulhat, hogy egy vezérlőelem több elem kijelölését is lehetővé teszi az inicializáláskor, de később csak egyetlen kijelölést engedélyez.

Kivételek

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

Kivétel típusa Állapot
ElementNotEnabledException Ha a vezérlő nincs engedélyezve.
InvalidOperationException Ha a vezérlő rejtett.

Lásd még

  • Last updated on