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。請注意，這個傳回值只是要求。屬性表可能仍會顯示預設頁面。