共用方式為


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 版或更新版本)