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
如果成功,则返回一个从 1 开始的索引,以指定最初应显示的页面。 有关更多信息,请参见备注。
注解
对于属性表处理程序需要添加到属性表的每个页面,处理程序将填充 PROPSHEETPAGE 结构,调用 CreatePropertySheetPage 函数,然后调用 pfnAddPage 指向的函数。
LPFNADDPROPSHEETPAGE 函数指针类型在 Prsht.h 中定义,如下所示。 它通过 lParam 接受 PROPSHEETPAGE 结构和函数定义数据的句柄。
typedef BOOL (* LPFNADDPROPSHEETPAGE)(HPROPSHEETPAGE, LPARAM);
可以通过实现请求首先显示特定的属性表页,而不是默认页面。 为此,请返回所需页面相对于所添加页面的从 1 开始的索引。 例如,如果添加了三个属性表页 A、B 和 C,并且希望 B 成为所选页面,则返回值应为 2。 请注意,此返回值只是一个请求。 属性表可能仍显示默认页面。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | shobjidl_core.h (包括 Shobjidl.h) |
DLL | Shell32.dll (版本 4.0 或更高版本) |