Sdílet prostřednictvím


Použití CPLAppletu

Před systémem Windows Vista jste vytvořili položku Ovládací panely vytvořením souboru .dll a pojmenováním s příponou .cpl. Tento soubor exportoval funkci CPlApplet. Toto schéma je stále podporováno v systému Windows Vista a novějších verzích a je popsáno v tomto tématu. Pokyny pro nové položky Ovládacích panelů však doporučují jednodušší přístup s položkou Ovládacích panelů sestavenou jako .exe soubor, který používá rozložení toku úloh.

Když Ovládací panely načte soubor .dll (nebo .cpl), zavolá funkci CPlApplet, která získá informace, například počet položek ovládacích panelů, které soubor hostuje, a také informace o každé položce. Ovládací panel také volá funkci, když je okno položky inicializováno, otevřeno nebo zavřeno.

Když Windows poprvé otevře položku Ovládací panel, načte adresu CPlApplet funkce a následně tuto adresu použije k zavolání funkce a odeslání zpráv. Může posílat následující zprávy.

Zpráva Popis
CPL_DBLCLK Odesláno s oznámením CPlApplet, že uživatel vybral ikonu přidruženou k dané položce Ovládacích panelů. CPlApplet by se mělo zobrazit dialogové okno pro zadanou položku a provádět všechny úkoly zadané uživatelem. Parametr CPlAppletlParam1 je celé číslo, které představuje index založený na nule položky Ovládacích panelů. Parametr lParam2 je ukazatel lpData, který byl vrácen ve struktuře CPLINFO nebo NEWCPLINFO, ve zprávě CPL_INQUIRE nebo CPL_NEWINQUIRE. Vrácená hodnota je ignorována.
CPL_EXIT Odesláno po poslední zprávě CPL_STOP, a bezprostředně před tím, než Windows použije funkci FreeLibrary k uvolnění knihovny DLL, která obsahuje položku Ovládací panely. CPlApplet by měl uvolnit zbývající paměť a připravit se na uzavření. Vrácená hodnota je ignorována.
CPL_GETCOUNT Odesláno po zprávě CPL_INIT, aby se vyzvalo CPlApplet, aby vrátilo číslo, které označuje, kolik podprogramů podporuje.
CPL_INIT Odesláno okamžitě po načtení knihovny DLL, která obsahuje položku Ovládacího panelu. Zpráva zobrazí výzvu CPlApplet k provedení inicializačních postupů, včetně přidělení paměti.
CPL_INQUIRE Odesláno po zprávě CPL_GETCOUNT v rámci výzvy CPlApplet poskytnout informace o specifikovaném podprogramu. Hodnota lParam1 je celé číslo, které představuje index podprogramu založený na nule, o kterém se požadují informace. lParam2 parametr CPlApplet odkazuje na strukturu CPLINFO. Vrácená hodnota je ignorována.
CPL_NEWINQUIRE Odesláno po zprávě CPL_GETCOUNT, aby vyzval CPlApplet k poskytnutí informací o specifikované položce Ovládacích panelů. Hodnota lParam1 je celé číslo, které představuje index podprogramu založený na nule, o kterém se požadují informace. Parametr lParam2 je ukazatel na strukturu NEWCPLINFO. CPL_NEWINQUIRE by měla být normálně ignorována. Aplikace by měla zpracovávat pouze CPL_INQUIRE v systémech Windows 95, Microsoft Windows NT 4.0 a novějších, protože výkon Ovládacích panelů trpí při použití CPL_NEWINQUIRE. Důvodem je to, že vrácené řetězce a ikony nelze uložit do mezipaměti. Vrácená hodnota je ignorována.
CPL_SELECT Zastaralý. Aktuální verze Systému Windows tuto zprávu neodesílají.
CPL_STARTWPARMS Odesláno s oznámením CPlApplet, že uživatel vybral ikonu přidruženou k danému dialogovému okně. CPlApplet by měl zobrazit odpovídající dialogové okno a provádět všechny uživatelem zadané úkoly. Tato zpráva je podobná CPL_DBLCLK, ale můžou existovat další informace. Parametr lParam1 je číslo položky Ovládacích panelů a lParam2 je LPCTSTR na jakékoli dodatečné pokyny, které mohou být nutné. Pokud je tato zpráva zpracována, vraťte TRUE; jinak vraťte FALSE. Tato zpráva je platná pro ve verzi 5.00 a novější verze Shell32.dll.
CPL_STOP Odesláno jednou pro každou položku v Ovládacím panelu v souboru .cpl předtím, než Windows vyloží rozšíření Ovládacího panelu. CPlApplet by měla uvolnit veškerou paměť přidruženou k číslu položky uvedené v lParam1. Parametr lParam2 je ukazatel lpData vrácený v CPLINFO nebo struktura NEWCPLINFO ve zprávě CPL_INQUIRE nebo CPL_NEWINQUIRE. Vrácená hodnota je ignorována.

 

položky ovládacích panelů

pokyny pro uživatelské prostředí

registrace položek ovládacích panelů

zpracování zpráv ovládacích panelů

provádění položek ovládacích panelů

rozšíření položek ovládacích panelů systému

přiřazení kategorií ovládacích panelů

Vytváření prohledávatelných odkazů na úkoly pro položku Ovládacího panelu

přístup k Ovládacím panelům v nouzovém režimu v systému Windows Vista