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 ) 時，不支援此訊息。