Menggunakan CPLApplet
Sebelum Windows Vista, Anda membuat item Panel Kontrol dengan membuat file .dll dan mennamakannya dengan ekstensi .cpl. File ini mengekspor fungsi CPlApplet . Skema ini masih didukung di Windows Vista dan versi yang lebih baru dan dibahas dalam topik ini. Namun, panduan untuk item Panel Kontrol baru merekomendasikan pendekatan yang lebih sederhana dengan item Panel Kontrol yang dibuat sebagai file .exe yang menggunakan tata letak alur tugas.
Ketika Panel Kontrol memuat file .dll (atau .cpl), ia memanggil fungsi CPlApplet untuk mendapatkan informasi seperti jumlah item Panel Kontrol host file, serta informasi tentang setiap item. Panel Kontrol juga memanggil fungsi saat jendela item diinisialisasi, dibuka, atau ditutup.
Ketika Windows pertama kali memuat item Panel Kontrol, Windows mengambil alamat fungsi CPlApplet dan kemudian menggunakan alamat tersebut untuk memanggil fungsi dan meneruskannya pesan. Ini mungkin mengirim pesan berikut.
| Pesan | Deskripsi |
|---|---|
| CPL_DBLCLK | Dikirim untuk memberi tahu CPlApplet bahwa pengguna telah memilih ikon yang terkait dengan item Panel Kontrol tertentu. CPlApplet harus menampilkan kotak dialog untuk item yang ditentukan dan melakukan tugas yang ditentukan pengguna. Parameter CPlApplet lParam1 adalah bilangan bulat yang mewakili indeks berbasis nol dari item Panel Kontrol. Parameter lParam2 adalah pointer lpData yang dikembalikan dalam struktur CPLINFO atau NEWCPLINFO dalam pesan CPL_INQUIRE atau CPL_NEWINQUIRE. Nilai yang dikembalikan diabaikan. |
| CPL_EXIT | Dikirim setelah pesan CPL_STOP terakhir dan segera sebelum Windows menggunakan fungsi FreeLibrary untuk membebaskan DLL yang berisi item Panel Kontrol. CPlApplet harus membebaskan memori yang tersisa dan bersiap untuk menutup. Nilai yang dikembalikan diabaikan. |
| CPL_GETCOUNT | Dikirim setelah pesan CPL_INIT untuk meminta CPlApplet mengembalikan angka yang menunjukkan berapa banyak subprogram yang didukungnya. |
| CPL_INIT | Dikirim segera setelah DLL yang berisi item Panel Kontrol dimuat. Pesan meminta CPlApplet untuk melakukan prosedur inisialisasi, termasuk alokasi memori. |
| CPL_INQUIRE | Dikirim setelah pesan CPL_GETCOUNT untuk meminta CPlApplet untuk memberikan informasi tentang subprogram tertentu. Nilai lParam1 adalah bilangan bulat yang mewakili indeks berbasis nol subprogram tentang informasi mana yang diminta. Parameter lParam2 CPlApplet menunjuk ke struktur CPLINFO. Nilai yang dikembalikan diabaikan. |
| CPL_NEWINQUIRE | Dikirim setelah pesan CPL_GETCOUNT untuk meminta CPlApplet untuk memberikan informasi tentang item Panel Kontrol tertentu. Nilai lParam1 adalah bilangan bulat yang mewakili indeks berbasis nol subprogram tentang informasi mana yang diminta. Parameter lParam2 adalah penunjuk ke struktur NEWCPLINFO . CPL_NEWINQUIRE biasanya harus diabaikan. Aplikasi Anda hanya boleh memproses CPL_INQUIRE pada sistem Windows 95, Microsoft Windows NT 4.0, dan yang lebih baru karena performa Panel Kontrol menderita saat CPL_NEWINQUIRE digunakan. Ini karena string dan ikon yang dikembalikan tidak dapat di-cache. Nilai yang dikembalikan diabaikan. |
| CPL_SELECT | Kedaluwarsa. Versi Windows saat ini tidak mengirim pesan ini. |
| CPL_STARTWPARMS | Dikirim untuk memberi tahu CPlApplet bahwa pengguna telah memilih ikon yang terkait dengan kotak dialog tertentu. CPlApplet harus menampilkan kotak dialog yang sesuai dan melakukan tugas yang ditentukan pengguna. Pesan ini mirip dengan CPL_DBLCLK, tetapi mungkin ada beberapa informasi tambahan. Parameter lParam1 adalah nomor item Panel Kontrol dan lParam2 adalah LPCTSTR ke arah tambahan yang mungkin diperlukan. Kembalikan TRUE jika pesan ini ditangani; jika tidak, FALSE. Pesan ini berlaku untuk Shell32.dll versi 5.00 dan yang lebih baru. |
| CPL_STOP | Dikirim sekali untuk setiap item Panel Kontrol dalam file .cpl sebelum Windows membongkar ekstensi Panel Kontrol. CPlApplet harus membebaskan memori apa pun yang terkait dengan nomor item yang disediakan di lParam1. Parameter lParam2 adalah penunjuk lpData yang dikembalikan dalam struktur CPLINFO atau NEWCPLINFO dalam pesan CPL_INQUIRE atau CPL_NEWINQUIRE. Nilai yang dikembalikan diabaikan. |
Topik terkait
-
Membuat Tautan Tugas yang Dapat Dicari untuk Item Panel Kontrol
-
Mengakses Panel Kontrol dalam Mode Aman di bawah Windows Vista