Tentang Properti Jendela
Properti jendela adalah data apa pun yang ditetapkan ke jendela. Properti jendela biasanya merupakan handel dari data khusus jendela, tetapi mungkin nilai apa pun. Setiap properti jendela diidentifikasi dengan nama string. Ada beberapa fungsi yang memungkinkan aplikasi menggunakan properti jendela. Gambaran umum ini membahas topik berikut:
Keuntungan Menggunakan Properti Jendela
Properti jendela biasanya digunakan untuk mengaitkan data dengan jendela subkelas atau jendela dalam aplikasi antarmuka beberapa dokumen (MDI). Dalam kedua kasus, tidak mudah untuk menggunakan byte tambahan yang ditentukan dalam fungsi CreateWindow atau struktur kelas karena dua alasan berikut:
- Aplikasi mungkin tidak tahu berapa banyak byte tambahan yang tersedia atau bagaimana ruang digunakan. Dengan menggunakan properti jendela, aplikasi dapat mengaitkan data dengan jendela tanpa mengakses byte tambahan.
- Aplikasi harus mengakses byte tambahan dengan menggunakan offset. Namun, properti jendela diakses oleh pengidentifikasi string mereka, bukan oleh offset.
Untuk informasi selengkapnya tentang subkelas, lihat Subkelas Prosedur Jendela. Untuk informasi selengkapnya tentang jendela MDI, lihat Beberapa Antarmuka Dokumen.
Menetapkan Properti Jendela
Fungsi SetProp menetapkan properti jendela dan pengidentifikasi stringnya ke jendela. Fungsi GetProp mengambil properti jendela yang diidentifikasi oleh string yang ditentukan. Fungsi RemoveProp menghancurkan hubungan antara jendela dan properti jendela tetapi tidak menghancurkan data itu sendiri. Untuk menghancurkan data itu sendiri, gunakan fungsi yang sesuai untuk membebaskan handel yang dikembalikan oleh RemoveProp.
Menghitung Properti Jendela
Fungsi EnumProps dan EnumPropsEx menghitung semua properti jendela dengan menggunakan fungsi panggilan balik yang ditentukan aplikasi. Untuk informasi selengkapnya tentang fungsi panggilan balik, lihat PropEnumProc.
EnumPropsEx menyertakan parameter tambahan untuk data yang ditentukan aplikasi yang digunakan oleh fungsi panggilan balik. Untuk informasi selengkapnya tentang fungsi panggilan balik, lihat PropEnumProcEx.