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

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

Jegyzet

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 ISelectionItemProvidermegvalósítására vonatkozó irányelveket és konvenciókat ismerteti, beleértve a tulajdonságokra, módszerekre és eseményekre vonatkozó információkat. A további hivatkozásokra mutató hivatkozások az áttekintés végén jelennek meg.

A SelectionItemPattern vezérlőminta azokat a vezérlőket támogatja, amelyek egyéni, kiválasztható gyermekelemekként működnek olyan tárolóvezérlőkben, amelyek a ISelectionProvider-et implementálják. A SelectionItem vezérlőmintát megvalósító vezérlők példáiért lásd felhasználói felületi automation-ügyfelekvezérlőminta-leképezését.

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

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

Az ISelectionItemProvider szükséges tagjai

A ISelectionItemProvidermegvalósításához a következő tulajdonságok, metódusok és események szükségesek.

Szükséges tagok Tagtípus Jegyzetek
IsSelected Ingatlan Egyik sem
SelectionContainer Ingatlan Egyik sem
AddToSelection Módszer Egyik sem
RemoveFromSelection Módszer Egyik sem
Select Módszer Egyik sem
ElementSelectedEvent Esemény Ha a kijelölés módosítása egyetlen kijelölt elemet eredményez.
ElementAddedToSelectionEvent Esemény Akkor merül fel, ha egy elem hozzáadódik egy többkijelöléses tárolóhoz.
ElementRemovedFromSelectionEvent Esemény Akkor merül fel, ha egy elem el lesz távolítva egy többkijelöléses tárolóból.
InvalidatedEvent Esemény Akkor merül fel, ha a tárolóban lévő kijelölés jelentősen megváltozott, és több ElementSelectedEvent és ElementRemovedFromSelectionEvent eseményt kell küldeni, mint amennyit a InvalidateLimit állandó engedélyez.

Kivételek

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

Kivétel típusa Feltétel
InvalidOperationException Az alábbiak bármelyikének megkísérlésekor:

- RemoveFromSelection egy olyan egykijelölésű tárolón van meghívva, amelyben IsSelectionRequiredProperty = true és egy elem már ki van jelölve.
- RemoveFromSelection egy többszörös kijelölésű tárolóban van meghívva, ahol IsSelectionRequiredProperty = true és csak egy elem van kijelölve.
- AddToSelection egy egykijelöléses tárolóban van meghívva, ahol már CanSelectMultipleProperty = false és egy másik elem van kijelölve.

Lásd még:

  • Last updated on