Struktur PROPPAGEINFO (ocidl.h)
Berisi parameter yang digunakan untuk menjelaskan halaman properti ke bingkai properti. Halaman properti mengisi struktur yang disediakan penelepon dalam metode IPropertyPage::GetPageInfo .
Sintaks
typedef struct tagPROPPAGEINFO {
ULONG cb;
LPOLESTR pszTitle;
SIZE size;
LPOLESTR pszDocString;
LPOLESTR pszHelpFile;
DWORD dwHelpContext;
} PROPPAGEINFO, *LPPROPPAGEINFO;
Anggota
cb
Ukuran struktur, dalam byte.
pszTitle
Penunjuk ke OLESTR yang berisi string yang muncul di tab untuk halaman ini. String harus dialokasikan dengan CoTaskMemAlloc. Pemanggil IPropertyPage::GetPageInfo bertanggung jawab untuk membebaskan memori dengan CoTaskMemFree.
size
Dimensi kotak dialog halaman yang diperlukan, dalam piksel.
pszDocString
Penunjuk ke string teks yang menjelaskan halaman, yang dapat ditampilkan dalam kotak dialog lembar properti (implementasi bingkai saat ini tidak menggunakan bidang ini). Teks harus dialokasikan dengan CoTaskMemAlloc. Pemanggil IPropertyPage::GetPageInfo bertanggung jawab untuk membebaskan memori dengan CoTaskMemFree.
pszHelpFile
Penunjuk ke OLESTR yang berisi nama sederhana file bantuan yang menjelaskan halaman properti ini yang digunakan alih-alih mengimplementasikan IPropertyPage::Help. Ketika pengguna menekan Bantuan, metode Bantuan biasanya dipanggil. Jika metode tersebut gagal, bingkai akan membuka sistem bantuan dengan file bantuan ini (diawali dengan nilai kunci HelpDir di entri registri halaman properti di bawah CLSID-nya) dan akan menginstruksikan sistem bantuan untuk menampilkan konteks yang dijelaskan oleh bidang dwHelpContext . Jalur harus dialokasikan dengan CoTaskMemAlloc. Pemanggil IPropertyPage::GetPageInfo bertanggung jawab untuk membebaskan memori dengan CoTaskMemFree.
dwHelpContext
Pengidentifikasi konteks untuk topik bantuan dalam pszHelpFile yang menjelaskan halaman ini.
Keterangan
Anggota pszTitle, pszDocString, dan pszHelpFile yang ditentukan dalam struktur ini harus berisi teks yang sensitif terhadap lokal yang diperoleh melalui IPropertyPageSite::GetLocaleID.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Header | ocidl.h |