A CPLApplet használata
A Windows Vista előtt létrehozott egy Vezérlőpult-elemet egy .dll fájl létrehozásával és .cpl kiterjesztéssel való elnevezésével. Ez a fájl exportálta a CPlApplet függvényt. Ez a séma továbbra is támogatott a Windows Vista és a későbbi verziókban, és ez a témakör ismerteti. Az új Vezérlőpult-elemekre vonatkozó irányelvek azonban egyszerűbb megközelítést javasolnak, mivel a Vezérlőpult elem .exe fájlként készült, amely feladatfolyamat-elrendezést használ.
Amikor a Vezérlőpult betölt egy .dll (vagy .cpl) fájlt, meghívja a CPlApplet függvényt, hogy olyan információkat kapjon, mint például a vezérlőpult elemeinek száma, a fájlgazda, valamint az egyes elemek adatai. A Vezérlőpult az elem ablakának inicializálása, megnyitása vagy bezárásakor is meghívja a függvényt.
Amikor a Windows először betölti a Vezérlőpult elemet, lekéri a CPlApplet függvény címét, majd ezt a címet használja a függvény meghívásához és az üzenetek továbbításához. A következő üzeneteket küldheti el.
| Üzenet | Leírás |
|---|---|
| CPL_DBLCLK | Értesítést küld CPlApplet, hogy a felhasználó egy adott Vezérlőpult-elemhez társított ikont választotta. CPlApplet meg kell jelenítenie a megadott elem párbeszédpaneljét, és végre kell hajtania a felhasználó által megadott feladatokat. A CPlAppletlParam1 paraméter egy egész szám, amely a Vezérlőpult elem nulla alapú indexét jelöli. Az lParam2 paraméter a lpData mutató, amelyet a CPLINFO vagy a NEWCPLINFO struktúrában adtak vissza a CPL_INQUIRE vagy a CPL_NEWINQUIRE üzenetben. A visszatérési értéket figyelmen kívül hagyjuk. |
| CPL_EXIT | Az utolsó CPL_STOP üzenet után, közvetlenül a Windows előtt, a FreeLibrary függvénnyel szabadítja fel a Vezérlőpult elemet tartalmazó DLL-t. CPlApplet felszabadítja a megmaradt memóriát, és készen áll a bezárásra. A visszatérési értéket figyelmen kívül hagyják. |
| CPL_GETCOUNT | A CPL_INIT üzenet után elküldve, hogy CPlApplet adjon vissza egy számot, amely jelzi, hogy hány alprogramot támogat. |
| CPL_INIT | A Vezérlőpult elemet tartalmazó DLL betöltése után azonnal elküldve. Az üzenet felkéri CPlApplet inicializálási eljárások végrehajtására, beleértve a memóriafoglalást is. |
| CPL_INQUIRE | CPL_GETCOUNT üzenet elküldése után a CPlApplet felkérést kap, hogy adjon információt egy adott alprogramról. Az lParam1 érték egy egész szám, amely annak az alprogramnak a nulla alapú indexét jelöli, amelyről az információ kérhető. A CPlAppletlParam2 paramétere egy CPLINFO struktúrára mutat. A visszatérési értéket figyelmen kívül hagyják. |
| CPL_NEWINQUIRE | A CPL_GETCOUNT üzenet után elküldve, hogy CPlApplet adjon meg információkat egy adott Vezérlőpult-elemről. Az lParam1 érték egy egész szám, amely annak az alprogramnak a nulla alapú indexét jelöli, amelyről az információ kérhető. Az lParam2 paraméter egy NEWCPLINFO struktúrára mutató mutató. CPL_NEWINQUIRE általában figyelmen kívül kell hagyni. Az alkalmazásnak csak a CPL_INQUIRE-t kell feldolgoznia a Windows 95, a Microsoft Windows NT 4.0 és újabb rendszereken, mivel a Vezérlőpult teljesítménye romlik, ha a CPL_NEWINQUIRE van használatban. Ennek az az oka, hogy a visszaadott karakterláncok és ikonok nem gyorsítótárazhatók. A visszatérési értéket figyelmen kívül hagyják. |
| CPL_SELECT | Elavult. A Windows jelenlegi verziói nem küldik el ezt az üzenetet. |
| CPL_STARTWPARMS | Értesítést küld CPlApplet, hogy a felhasználó az adott párbeszédpanelhez társított ikont választotta. CPlApplet meg kell jelenítenie a megfelelő párbeszédpanelt, és végre kell hajtania a felhasználó által megadott feladatokat. Ez az üzenet hasonló a CPL_DBLCLK üzenethez, de lehet, hogy további információk is vannak. Az lParam1 paraméter a Vezérlőpult elemszáma, az lParam2 pedig LPCTSTR minden további szükséges irányhoz. Igaz IGAZ visszaadása, ha az üzenet kezelése megtörtént; ellenkező esetben HAMIS . Ez az üzenet a 5.00-es és újabbak verzióira érvényes Shell32.dllesetében. |
| CPL_STOP | A .cpl fájl minden Vezérlőpult-elemére egyszer elküldve, mielőtt a Windows eltávolítja a Vezérlőpult bővítményt. CPlApplet-nak fel kell szabadítania minden, az lParam1által megadott elem számával kapcsolatos memóriát. Az lParam2 paraméter egy lpData mutató, amelyet a CPL_INQUIRE vagy CPL_NEWINQUIRE üzenetben adnak vissza a CPLINFO vagy a NEWCPLINFO struktúrában. A visszatérési értéket figyelmen kívül hagyjuk. |
Kapcsolódó témakörök
-
Vezérlőpult-elem kereshető tevékenységhivatkozásainak létrehozása
-
A Vezérlőpult elérése csökkentett módban a Windows Vista rendszeren