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

Lihat juga

IPropertyPage::GetPageInfo

IPropertyPageSite::GetLocaleID

OLESTR