Membuat Properti Kustom

  • Artikel

Properti yang digunakan dalam sistem properti Windows Vista dan kemudian 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 hal itu dapat ditampilkan di UI Windows, jenis label (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 dan menggunakan konvensi namespace layanan 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-nama ini. Nama kanonis digunakan di berbagai tempat termasuk daftar properti dan nama kolom dalam cache properti. Oleh karena itu, kueri tersebut digunakan dalam kueri Bahasa Permintaan Terstruktur (SQL) untuk mengambil nilai properti.

PKEY adalah sepasang nilai yang terdiri dari GUID dan DWORD, masing-masing disebut sebagai formatID dan propID . Ini diwakili oleh struktur PROPERTYKEY . Sebagian besar API sistem properti menerima kunci properti ini. Kit Pengembangan Perangkat Lunak Windows (SDK) menyertakan file header Propkey.h yang menyertakan definisi makro dari System masing-masing 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 untuk memiliki perubahan ini yang 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