通过

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 指针 cObjects 数组。

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

要求

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

另请参阅

IPropertyPage：：SetObjects

IPropertyPageSite：：GetLocaleID