IShellPropSheetExt::AddPages 方法 (shobjidl_core.h)

向 Shell 为文件对象显示的属性表添加一个或多个页面。 Shell 针对注册到文件类型的每个属性表处理程序调用此方法。

语法

HRESULT AddPages(
  [in] LPFNSVADDPROPSHEETPAGE pfnAddPage,
  [in] LPARAM                 lParam
);

参数

[in] pfnAddPage

类型: LPFNADDPROPSHEETPAGE

指向属性表处理程序调用将页面添加到属性表的函数的指针。 该函数采用 CreatePropertySheetPage 函数返回的属性表句柄和传递给此方法的 lParam 参数。

[in] lParam

类型: LPARAM

要传递给 pfnAddPage 指向的函数的特定于处理程序的数据。

返回值

类型: HRESULT

如果成功,则返回一个基于一个索引以指定最初应显示的页。 有关更多信息,请参见备注。

注解

对于属性表处理程序需要添加到属性表的每个页面,处理程序将填充 PROPSHEETPAGE 结构,调用 CreatePropertySheetPage 函数,然后调用 pfnAddPage 指向的函数。

LPFNADDPROPSHEETPAGE 函数指针类型在 Prsht.h 中定义,如下所示。 它通过 lParam 接受 PROPSHEETPAGE 结构和函数定义数据的句柄。

typedef BOOL (* LPFNADDPROPSHEETPAGE)(HPROPSHEETPAGE, LPARAM);

可以通过实现请求先显示特定属性表页,而不是默认页面。 为此,请返回所需页面相对于所添加页面的基于一个的索引。 例如,如果添加了三个属性表页 A、B 和 C,并且希望 B 成为所选页面,则返回值应为 2。 请注意,此返回值只是请求。 属性表可能仍显示默认页面。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)
DLL Shell32.dll (4.0 或更高版本)