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


A felhasználói felület automatizálási dokkolójának vezérlő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 IDockProvidervonatkozó irányelveket és konvenciókat ismerteti, beleértve a 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 DockPattern vezérlőminta egy vezérlő dokkoló tulajdonságainak egy dokkolótárolón belüli felfedésére szolgál. A dokkolótárolók olyan vezérlők, amelyek lehetővé teszik a gyermekelemek vízszintes és függőleges elrendezését egymáshoz képest. 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.

Dokkoló konténer két dokkolt gyerekkel. Dokkolási példa a Visual Studioból, ahol a "Class View" ablak helyzete DockPosition.Right és az "Error List" ablak helyzete DockPosition.Bottom.

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

A Dock-vezérlési minta megvalósításakor vegye figyelembe az alábbi irányelveket és konvenciókat:

  • IDockProvider nem teszi elérhetővé a dokkolótároló egyik tulajdonságát sem, sem a dokkolótárolón belüli aktuális vezérlő mellett rögzített vezérlők tulajdonságait.

  • A vezérlők egymáshoz képest vannak rögzítve az aktuális z-sorrendjük alapján; minél magasabb a z-order elhelyezésük, annál távolabb kerülnek a dokkolótároló megadott szélétől.

  • Ha a dokkolótároló átméretezve van, a tárolóban lévő dokkolt vezérlők öblítve lesznek ugyanarra a szélre, amelyhez eredetileg rögzítették őket. A rögzített vezérlők úgy is átméreteződnek, hogy a tárolón belül bármilyen helyet kitölthessenek DockPositiona tároló dokkolási viselkedésének megfelelően. Ha például Top meg van adva, a vezérlőelem bal és jobb oldala ki fog bontani, hogy kitöltse a rendelkezésre álló területet. Ha Fill meg van adva, a vezérlőelem mind a négy oldala ki fog bővülni, hogy kitöltse a rendelkezésre álló területet.

  • Többmonitoros rendszerben a vezérlőknek az aktuális monitor bal vagy jobb oldalára kell dokkolnak. Ha ez nem lehetséges, akkor a bal szélső monitor bal oldalára vagy a jobb szélső monitor jobb oldalára kell dokkolniuk.

Az IDockProvider szükséges tagjai

Az IDockProvider felület implementálásához a következő tulajdonságokra és módszerekre van szükség.

Kötelező tagok Tagtípus Jegyzetek
DockPosition Ingatlan Egyik sem
SetDockPosition Metódus Egyik sem

Ez a vezérlőminta nem rendelkezik társított eseményekkel.

Kivételek

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

Kivétel típusa Állapot
InvalidOperationException SetDockPosition

- Ha egy vezérlő nem képes végrehajtani a kért dock stílust.

Lásd még