共用方式為


PSM_INSERTPAGE訊息

將新頁面插入現有的屬性工作表。 頁面可以插入指定的索引處,或在指定的頁面之後插入。 您可以明確傳送此訊息,或使用 PropSheet_InsertPage 宏。

參數

wParam

要插入頁面的位置。 將此參數設定為 Null ,讓新頁面成為第一頁。 若要指定要插入新頁面的位置,您可以傳遞索引或現有頁面的 HPROPSHEETPAGE 控制碼。

意義
索引
如果 wParam 參數小於 MAXUSHORT (最大不帶正負號的短整數) , wParam 會指定新頁面以零起始的索引。 例如,若要將插入的頁面設為屬性工作表上的第三頁,請將 wParam 設定為 2。 若要讓它成為第一頁,請將 wParam 設定為 0。 如果 wParam 的值大於頁數,且小於 MAXUSHORT,則會附加頁面。
hpageInsertAfter
如果您將 wParam 參數設定為現有頁面的 HPROPSHEETPAGE 控制碼,則會在它之後插入新的頁面。

lParam

要插入的頁面控制碼。 必須先呼叫 CreatePropertySheetPage 函式來建立頁面。

傳回值

如果已成功插入頁面,則傳回非零值,否則傳回零。

備註

插入點之後的頁面會向右移位以容納新的頁面。

屬性工作表不會調整大小以符合新頁面。 請勿讓新頁面大於屬性工作表的最大頁面。

屬性工作表正在動作頁面清單時,會發生一些訊息和一個函式呼叫。 發生此動作時,嘗試修改頁面清單將會產生無法預測的結果。 因此,您不應該在 PropSheetPageProc 的實作中使用PSM_INSERTPAGE訊息,或在處理下列通知和 Windows 訊息時使用。

如果您在處理其中一則訊息或 PropSheetPageProc 運作時,需要修改屬性工作表頁面,請自行張貼私人 Windows 訊息。 您的應用程式在屬性工作表管理員完成其工作之後,才會收到該訊息。 然後,您可以修改頁面清單。

下列通知也會受到屬性工作表修改的影響。

您可以新增或移除頁面以回應這些通知,前提是您可以透過DWL_MSGRESULT) 非零值傳回 (,以指定所需的新頁面。 不過請注意,如果您插入位於目前頁面之前的頁面, (索引小於目前頁面) , PSN_KILLACTIVE 可能會傳送到錯誤的頁面。

注意

使用 (精靈樣式PSH_AEROWIZARD ) 時,不支援此訊息。

規格需求

需求
最低支援的用戶端
Windows Vista [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2003 [僅限傳統型應用程式]
標頭
Prsht.h