Cara Mendaftar dan Menerapkan Handler Lembar Properti untuk Aplikasi Panel Kontrol

Banyak aplikasi Panel Kontrol menampilkan lembar properti Properti untuk memungkinkan pengguna melihat dan memodifikasi berbagai pengaturan perangkat dan sistem. Dua aplikasi ini—Mouse dan Tampilan—memungkinkan penangan lembar properti mengganti satu atau beberapa halamannya dengan halaman kustom. Cuplikan layar berikut menunjukkan lembar properti Properti Mouse .

Handler lembar properti untuk aplikasi Panel Kontrol mirip dengan aplikasi untuk jenis file, dengan dua pengecualian utama:

• Mereka dipanggil oleh aplikasi Panel Kontrol, bukan Shell.
• Mereka terdaftar secara berbeda.

Apa yang perlu Anda ketahui

Teknologi

• Shell

Prasyarat

• Pemahaman tentang Panel Kontrol
• Pemahaman tentang menu pintasan

Petunjuk

Langkah 1: Mendaftarkan Handler Lembar Properti untuk Aplikasi Panel Kontrol

Handler lembar properti aplikasi Panel Kontrol harus didaftarkan di bawah subkunji Panel Kontrol. Kunci ini dapat berada di salah satu dari dua lokasi, tergantung pada apakah handler akan menjadi per pengguna atau per komputer. Untuk pendaftaran per pengguna, subkundang Panel Kontrol HKEY_CURRENT_USER\Panel Kontrol. Makro REGSTR_PATH_CONTROLPANEL seperti yang didefinisikan dalam Regstr.h dapat digunakan dalam kode sebagai ganti "Panel Kontrol". Untuk pendaftaran per komputer, lokasinya adalah:

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            Current Version
               Controls Folder

Jalur ini dapat disebut dalam kode sebagai HKEY_LOCAL_MACHINE\REGSTR_PATH_CONTROLSFOLDER, menggunakan makro REGSTR_PATH_CONTROLSFOLDER yang ditentukan dalam Regstr.h.

Aplikasi Panel Kontrol yang memungkinkan penangan lembar properti untuk mengganti halaman memiliki subkunci di bawah subkunci Panel Kontrol, yang dinamai untuk aplikasi, seperti Mouse dan Tampilan. Subkunjuk aplikasi harus memiliki subkuncuk shellex dengan subkunjuk PropertySheetHandlers . Untuk mendaftarkan handler lembar properti, tambahkan GUID-nya ke subkey PropertySheetHandlers yang terkait dengan aplikasi Panel Kontrol. Untuk melakukannya, buat subkunci subkunci PropertySheetHandlers , bernama untuk handler lembar properti, dan atur nilai defaultnya ke bentuk string GUID handler.

Contoh berikut mendaftarkan handler lembar properti untuk aplikasi Mouse Panel Kontrol berdasarkan per komputer. Untuk mendaftarkannya per pengguna, ganti REGSTR_PATH_CONTROLSFOLDER HKEY_LOCAL_MACHINE\ denganREGSTR_PATH_CONTROLPANEL HKEY_CURRENT_USER\.

HKEY_LOCAL_MACHINE
   REGSTR_PATH_CONTROLSFOLDER
      Mouse
         shellex
            PropertySheetHandlers
               MyPropHandler
                  (Default) = {MyPropHandler CLSID GUID}

Langkah 2: Menerapkan Handler Lembar Properti untuk Aplikasi Panel Kontrol

Prosedur untuk menerapkan handler lembar properti Panel Kontrol sangat mirip dengan yang dibahas dalam Cara Mendaftar dan Menerapkan Handler Lembar Properti untuk Jenis File. Perbedaan utamanya adalah bahwa sekarang IShellPropSheetExt::ReplacePage membutuhkan implementasi nontoken alih-alih IShellPropSheetExt::AddPages.

Ketika aplikasi Panel Kontrol akan menampilkan lembar propertinya, aplikasi memanggil metode IShellPropSheetExt::ReplacePage handler properti sekali untuk setiap halaman yang dapat diganti. Parameter uPageID diatur ke ID halaman. ID untuk halaman yang tersedia ditentukan dalam Cplext.h. ID yang saat ini tersedia tercantum dalam tabel berikut.

ID Halaman	Deskripsi	aplikasi Panel Kontrol
CPLPAGE_MOUSE_BUTTONS	Halaman Tombol	Mouse
CPLPAGE_MOUSE_PTRMOTION	Halaman Gerakan	Mouse
CPLPAGE_MOUSE_WHEEL	Halaman Roda	Mouse
CPLPAGE_KEYBOARD_SPEED	Halaman Kecepatan	Keyboard
CPLPAGE_DISPLAY_BACKGROUND	Halaman Latar Belakang	Tampilan

 

Keterangan

Prosedur untuk membuat dan mengganti halaman identik dengan itu untuk menambahkan halaman. Untuk informasi selengkapnya, lihat Cara Mendaftar dan Mengimplementasikan Handler Lembar Properti untuk Jenis File.