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 Display—memungkinkan handler lembar properti mengganti satu atau beberapa halamannya dengan halaman kustom. Cuplikan layar berikut menunjukkan lembaran properti Properti Mouse.

Handler lembar properti untuk aplikasi Panel Kontrol mirip dengan yang 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

Peraturan

Langkah 1: Mendaftarkan Handler Lembar Properti untuk Aplikasi Panel Kontrol

Handler lembar properti aplikasi Panel Kontrol harus terdaftar di subkunci 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, subkunjuk Panel Kontrol HKEY_CURRENT_USER\Panel Kontrol. Makro REGSTR_PATH_CONTROLPANEL seperti yang didefinisikan dalam Regstr.h dapat digunakan dalam kode sebagai pengganti "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 pengelola lembar properti untuk mengganti halaman memiliki subkunci di bawah subkunci Panel Kontrol, yang dinamai sesuai dengan aplikasi, seperti Mouse dan Display. Subkunci aplikasi harus memiliki subkunci shellex dengan subkunci PropertySheetHandlers. Untuk mendaftarkan pengelola lembar properti, tambahkan GUID-nya ke subkunji PropertySheetHandlers yang terkait dengan aplikasi Control Panel. Untuk melakukannya, buat subkunci di dalam subkunci PropertySheetHandlers dengan nama sesuai dengan handler lembar properti, dan atur nilai defaultnya ke bentuk string dari GUID handler tersebut.

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

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 memerlukan implementasi nontoken alih-alih IShellPropSheetExt::AddPages.

Ketika aplikasi Panel Kontrol akan menampilkan lembar propertinya, aplikasi ini memanggil metode lembar properti dari pengendali, yaitu IShellPropSheetExt::ReplacePage sekali untuk setiap halaman yang bisa diganti. Parameter uPageID diatur menjadi 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
Tombol Mouse di Halaman CPL	Halaman Tombol	Tikus
CPLPAGE_MOUSE_PTRMOTION	Halaman Gerakan	Tikus
CPLPAGE_MOUSE_WHEEL	Halaman Roda	Tikus
Kecepatan Keyboard	Halaman Kecepatan	Papan ketik
Latar Belakang Tampilan CPLPAGE	Halaman Latar Belakang	Menampilkan

 

Komentar

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