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。请注意，此返回值只是一个请求。属性表可能仍显示默认页面。