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 数组，其中包含要显示在属性表中的每个属性页的 CLSD。

[in] lcid

要用于属性表的区域设置标识符。 属性页可以通过 IPropertyPageSite：：GetLocaleID 检索此标识符。

[in] dwReserved

留待将来使用；必须为零。

[in] pvReserved

保留供将来使用;必须为 NULL。

返回值

此函数支持标准返回值E_INVALIDARG、E_OUTOFMEMORY和E_UNEXPECTED，以及以下值：

返回代码	说明
S_OK	对话框已调用并成功操作。
E_POINTER	lpszCaption、ppUnk 或 pPageCIsID 中的地址无效。 例如，其中任何一个都可以为 NULL。

注解

要显示的属性页使用 pPageClsID 标识，pPageClsID 是 cPagesCLSID 值的数组。 受此属性表影响的对象在 ppUnk 中标识，ppUnk 是一个包含 IUnknown 指针的大小 cObject 数组。

此函数始终创建模式对话框，在对话框关闭之前不会返回。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	olectl.h
Library	OleAut32.lib
DLL	OleAut32.dll

另请参阅

IPropertyPage：：SetObjects

IPropertyPageSite：：GetLocaleID