共用方式為

OleCreatePropertyFrame 函式 （olectl.h）

  • 發行項

叫用新的屬性框架，也就是屬性表對話方塊，其父系 hwndOwner，其中對話框位於父視窗的點 （x，y） 位置，且標題 lpszCaption。

語法

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
);

參數

[in] hwndOwner

所產生屬性表對話框之父視窗的句柄。

[in] x

保留。 對話框相對於 hwndOwner的水準位置。

[in] y

保留。 對話框相對於 hwndOwner的垂直位置。

[in] lpszCaption

用於對話框標題之字串的指標。

[in] cObjects

ppUnk中傳遞的物件指標數目。

[in] ppUnk

要叫用此屬性表的物件上 IUnknown 指標的陣列。 陣列中的項目數目是由 cObjects 指定。 這些指標會透過 IPropertyPage：：SetObjects傳遞至每個屬性頁。

[in] cPages

pPageCIsID 中指定的屬性頁數目。

[in] pPageClsID

大小 cPages 陣列， 包含要顯示在屬性表中之每個屬性頁的 CLSID。

[in] lcid

屬性表所使用的地區設定標識碼。 屬性頁可以透過 IPropertyPageSite：：GetLocaleID擷取此標識碼。

[in] dwReserved

保留供日後使用;必須是零。

[in] pvReserved

保留供日後使用;必須 NULL。

傳回值

此函式支持標準傳回值E_INVALIDARG、E_OUTOFMEMORY和E_UNEXPECTED，以及下列各項：

傳回碼 描述
S_OK
 已成功叫用並操作對話框。
E_POINTER
 lpszCaption、ppUnk或 pPageCIsID 中的地址無效。 例如，其中任何一個都可以 NULL。

言論

要顯示的屬性頁會以 pPageClsID識別，這是 cPagesCLSID 值的 陣列。 受這個屬性表影響的對象會識別在 ppUnk中，這是包含 IUnknown 指標 iUnknown 大小 cObjects 陣列。

此函式一律會建立強制回應對話框，而且在關閉對話方塊之前不會傳回。

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 olectl.h
連結庫 OleAut32.lib
DLL OleAut32.dll

另請參閱

IPropertyPage：：SetObjects

IPropertyPageSite：：GetLocaleID