Bagikan melalui

Membuat Properti Kustom

  • Artikel

Properti yang digunakan dalam sistem properti Windows Vista dan yang lebih baru dinyatakan dalam skema properti. Skema properti ini didefinisikan dalam file XML dan menjelaskan berbagai aspek properti termasuk jenisnya (termasuk informasi tentang jenis primitifnya dan apakah itu multinilai), bagaimana dapat ditampilkan di UI Windows, jenis label apa (string pengeditan yang mudah digunakan) yang akan digunakan dengannya, dan bagaimana itu di-cache di penyimpanan pencarian untuk akses yang lebih cepat. Properti diidentifikasi dengan Nama Kanonis atau Kunci Properti (PKEY) mereka.

Nama kanonis adalah nama properti yang mudah dibaca pembaca dan menggunakan konvensi namespace yang mirip dengan yang digunakan di Microsoft .NET. Untuk properti yang ditentukan sistem (yang disertakan dengan Windows), konvensinya adalah System.GroupName.PropertyName. Perhatikan bahwa skema casing Pascal, yang memanfaatkan huruf di awal setiap kata, digunakan dalam nama ini. Nama kanonis digunakan di berbagai tempat termasuk daftar properti dan nama kolom dalam cache properti. Oleh karena itu, mereka digunakan dalam kueri Bahasa Permintaan Terstruktur (SQL) untuk mengambil nilai properti.

PKEY adalah sepasang nilai yang terdiri dari GUID dan DWORD, yang masing-masing disebut sebagai formatID dan propID . Ini diwakili oleh struktur PROPERTYKEY. Sebagian besar API sistem properti menerima kunci properti ini. Windows Software Development Kit (SDK) menyertakan file header Propkey.h yang menyertakan definisi makro dari System setiap kunci properti dengan konvensi PKEY_GroupName_PropertyName. Misalnya, PKEY_Photo_DateTaken adalah kunci properti untuk properti dengan nama System.Photo.DateTakenkanonis . Nilai properti disimpan dalam bentuk struktur PROPVARIANT , yang merupakan ekstensi dari jenis VARIAN OLE.

Bagian ini berisi topik berikut, yang merupakan integral untuk membuat properti kustom:

Catatan

Karena potensi kesulitan yang mungkin dimiliki pengindeks saat mengonsumsi skema sistem properti, sangat penting bagi Anda untuk menentukan atribut dengan hati-hati dan strategis untuk rilis pertama skema. Setiap perubahan pada atribut (jenis, lebar kolom, apakah dapat diindeks) tidak akan tercermin dalam database setelah skema didaftarkan. Satu-satunya cara agar perubahan ini dikenali setelah skema didaftarkan sekali pada sistem adalah dengan membangun kembali indeks dan kemudian mendaftarkan skema baru, atau untuk mendaftarkan skema dan kemudian membuat properti baru untuk setiap rilis berikutnya; misalnya PKEY_GroupName_PropertyNameV2, PKEY_GroupName_PropertyNameV3, dan sebagainya). Kami tidak menyarankan untuk membuat properti baru dengan cara ini, karena beberapa kolom asing dapat memengaruhi performa sistem.

 

Menerapkan Handler Properti

Skema Deskripsi Properti