Fungsi OleCreatePropertyFrame (olectl.h)

Artikel
08/25/2023

Memanggil bingkai properti baru, yaitu, kotak dialog lembar properti, yang induknya adalah hwndOwner, tempat dialog diposisikan pada titik (x,y) di jendela induk dan memiliki caption lpszCaption.

Sintaks

WINOLECTLAPI OleCreatePropertyFrame(
  [in] HWND      hwndOwner,
  [in] UINT      x,
  [in] UINT      y,
  [in] LPCOLESTR lpszCaption,
  [in] ULONG     cObjects,
  [in] LPUNKNOWN *ppUnk,
  [in] ULONG     cPages,
  [in] LPCLSID   pPageClsID,
  [in] LCID      lcid,
  [in] DWORD     dwReserved,
  [in] LPVOID    pvReserved
);

Parameter

[in] hwndOwner

Tangani ke jendela induk dari kotak dialog lembar properti yang dihasilkan.

[in] x

Dicadangkan. Posisi horizontal untuk kotak dialog relatif terhadap hwndOwner.

[in] y

Dicadangkan. Posisi vertikal untuk kotak dialog relatif terhadap hwndOwner.

[in] lpszCaption

Penunjuk ke string yang digunakan untuk caption kotak dialog.

[in] cObjects

Jumlah pointer objek yang diteruskan dalam ppUnk.

[in] ppUnk

Array pointer IUnknown pada objek yang lembar properti ini sedang dipanggil. Jumlah elemen dalam array ditentukan oleh cObjects. Pointer ini diteruskan ke setiap halaman properti melalui IPropertyPage::SetObjects.

[in] cPages

Jumlah halaman properti yang ditentukan dalam pPageCIsID.

[in] pPageClsID

Array cPages ukuran yang berisi CLSID dari setiap halaman properti untuk ditampilkan di lembar properti.

[in] lcid

Pengidentifikasi lokal yang digunakan untuk lembar properti. Halaman properti dapat mengambil pengidentifikasi ini melalui IPropertyPageSite::GetLocaleID.

[in] dwReserved

Dicadangkan untuk digunakan di masa mendatang; harus nol.

[in] pvReserved

Dicadangkan untuk digunakan di masa mendatang; harus NULL.

Mengembalikan nilai

Fungsi ini mendukung nilai pengembalian standar E_INVALIDARG, E_OUTOFMEMORY, dan E_UNEXPECTED, serta berikut ini:

Menampilkan kode	Deskripsi
S_OK	Kotak dialog dipanggil dan berhasil dioperasikan.
E_POINTER	Alamat dalam lpszCaption, ppUnk, atau pPageCIsID tidak valid. Misalnya, salah satunya mungkin NULL.

Keterangan

Halaman properti yang akan ditampilkan diidentifikasi dengan pPageClsID, yang merupakan array nilai cPagesCLSID . Objek yang terpengaruh oleh lembar properti ini diidentifikasi dalam ppUnk, array cObjects ukuran yang berisi pointer IUnknown .

Fungsi ini selalu membuat kotak dialog modal dan tidak kembali sampai kotak dialog ditutup.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	olectl.h
Pustaka	OleAut32.lib
DLL	OleAut32.dll

Lihat juga

IPropertyPage::SetObjects

IPropertyPageSite::GetLocaleID