Fungsi OleCreatePropertyFrame (olectl.h)

Artikel
07/16/2024

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

Sintaksis

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

Dipesan. Posisi horizontal untuk kotak dialog relatif terhadap hwndOwner.

[in] y

Dipesan. Posisi vertikal untuk kotak dialog relatif terhadap hwndOwner.

[in] lpszCaption

Penunjuk ke string yang digunakan untuk keterangan kotak dialog.

[in] cObjects

Jumlah penunjuk objek yang diteruskan ppUnk.

[in] ppUnk

Array penunjuk IUnknown pada objek tempat lembar properti ini 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 ukuran cPages berisi CLSID dari setiap halaman properti untuk ditampilkan di lembar properti.

[in] lcid

Pengidentifikasi lokal yang akan 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 yang berikut ini:

Mengembalikan 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.

Komentar

Halaman properti yang akan ditampilkan diidentifikasi dengan pPageClsID, yang merupakan array cPagesnilai CLSID. Objek yang dipengaruhi oleh lembar properti ini diidentifikasi dalamppUnk , array ukuran cObjects yang berisi pointer IUnknown.

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

Persyaratan

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

Lihat juga

IPropertyPage::SetObjects

IPropertyPageSite::GetLocaleID

Bagikan melalui