Handler Lembar Properti

Saat pengguna mengklik kanan objek Shell, menu pintasan yang ditampilkan biasanya menyertakan item Properti . Memilih item tersebut meluncurkan lembar properti yang memungkinkan pengguna untuk melihat, dan dalam beberapa kasus memodifikasi, properti objek. Anda dapat menyesuaikan lembar properti ini dengan menerapkan dan mendaftarkan handler lembar properti.

Prosedur umum untuk menerapkan dan mendaftarkan handler ekstensi Shell dibahas dalam Membuat Penangan Ekstensi Shell. Dokumen ini berfokus pada aspek implementasi yang khusus untuk penangan lembar properti.

• Cara Kerja Handler Lembar Properti
• Mendaftarkan dan Menerapkan Handler Lembar Properti untuk Drive yang Dipasang
• Topik terkait

Cara Kerja Handler Lembar Properti

Ilustrasi berikut ini memperlihatkan lembar properti Properti untuk file teks Windows XP.

Ilustrasi ini memperlihatkan lembar properti Properti default yang ditampilkan untuk file apa pun. Untuk banyak lembar properti tersebut, Anda dapat menambahkan satu atau beberapa halaman ke lembar properti dengan menerapkan dan mendaftarkan handler lembar properti.

Handler lembar properti paling umum didaftarkan untuk jenis file. Setiap handler dapat menambahkan satu halaman kustom ke lembar properti Properti untuk kelas . Halaman-halaman ini biasanya memberi pengguna akses ke properti yang khusus untuk jenis file tertentu. Jenis file yang terdiri dari dokumen teks dapat, misalnya, menampilkan halaman yang mencantumkan judul dan penulis, dan abstrak dokumen. Kasus khusus dari jenis handler lembar properti ini digunakan untuk menambahkan halaman ke lembar properti Properti untuk drive yang dipasang.

Penggunaan lain untuk handler lembar properti adalah mengganti halaman dalam lembar properti yang ditampilkan oleh aplikasi Panel Kontrol. Produsen mouse, misalnya, dapat menggunakan handler lembar properti untuk mengganti halaman Tombol pada lembar properti Properti Mouse Panel Kontrol dengan halaman yang disesuaikan untuk karakteristik mousenya.

Seperti semua penangan ekstensi Shell, penangan lembar properti adalah objek Model Objek Komponen (COM) dalam proses yang diimplementasikan sebagai DLL. Mereka harus mengekspor dua antarmuka selain IUnknown: IShellExtInit dan IShellPropSheetExt.

Antarmuka IShellExtInit digunakan oleh Shell untuk menginisialisasi handler. Ketika Shell memanggil IShellExtInit::Initialize, Shell meneruskan objek data dengan nama objek, dan penunjuk ke daftar pengidentifikasi item (PIDL) folder yang berisi file. Parameter hRegKey tidak digunakan dengan handler lembar properti. Metode IShellExtInit::Initialize harus mengekstrak nama file dari objek data, dan menyimpan nama dan PIDL folder untuk digunakan nanti. Untuk detail lebih lanjut, lihat bagian Menerapkan IShellExtInit dari Membuat Penangan Ekstensi Shell.

Sisa operasi berlangsung melalui antarmuka IShellPropSheetExt handler. Jika lembar properti dikaitkan dengan jenis file, Shell memanggil IShellPropSheetExt::AddPages untuk memungkinkan handler menambahkan halaman ke lembar properti. Jika lembar properti dikaitkan dengan aplikasi Panel Kontrol, Shell memanggil IShellPropSheetExt::ReplacePage untuk memungkinkan handler mengganti halaman.

Mendaftarkan dan Menerapkan Handler Lembar Properti untuk Drive yang Dipasang

Setiap drive yang dipasang memiliki lembar Properti yang dapat ditampilkan oleh pengguna. Ilustrasi berikut menunjukkan lembar properti Properti untuk drive CD-ROM.

Ada berbagai perangkat yang dapat dipasang sebagai drive. Karena lembar properti default, yang dirancang untuk drive disk, mungkin tidak cukup untuk beberapa perangkat, handler lembar properti dapat diimplementasikan untuk menambahkan halaman yang khusus untuk perangkat yang dipasang. Implementasi dasar jenis handler lembar properti ini identik dengan yang dibahas dalam Cara Mendaftarkan dan Menerapkan Handler Lembar Properti untuk Jenis File, dengan dua pengecualian.

• Objek data yang diteruskan ke metode IShellExtInit::Initialize handler mungkin berisi jalur drive dalam format CFSTR_MOUNTEDVOLUME alih-alih format CF_HDROP . Format CF_HDROP digunakan saat perangkat dipasang ke huruf kandar. Format CFSTR_MOUNTEDVOLUME digunakan dengan sistem file NTFS ketika perangkat jarak jauh dipasang ke folder daripada ke huruf kandar.
• GUID handler terdaftar di bawah kunci HKEY_CLASSES_ROOT\Drive\shellex\PropertySheetHandlers .

Topik terkait

Cara Mendaftar dan Menerapkan Handler Lembar Properti untuk Jenis File

Cara Mendaftar dan Menerapkan Handler Lembar Properti untuk Aplikasi Panel Kontrol