Menggunakan CPLApplet

  • Artikel

Sebelum Windows Vista, Anda membuat item Panel Kontrol dengan membuat file .dll dan memberi nama 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.

Saat Panel Kontrol memuat file .dll (atau .cpl), file tersebut 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 CPlAppletlParam1 adalah bilangan bulat yang mewakili indeks berbasis nol dari item Panel Kontrol. Parameter lParam2 adalah penunjuk 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 dari CPlApplet menunjuk ke struktur CPLINFO . Nilai yang dikembalikan diabaikan.
CPL_NEWINQUIRE Dikirim setelah pesan CPL_GETCOUNT untuk meminta CPlApplet 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 valid 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.

 

Item Panel Kontrol

Panduan Pengalaman Pengguna

Mendaftarkan Item Panel Kontrol

Pemrosesan Pesan Panel Kontrol

Menjalankan Item Panel Kontrol

Memperluas Item Panel Kontrol Sistem

Menetapkan Kategori Panel Kontrol

Membuat Tautan Tugas yang Dapat Dicari untuk Item Panel Kontrol

Mengakses Panel Kontrol dalam Mode Aman di bawah Windows Vista