PropSheet_InsertPage宏 (prsht.h)

將新頁面插入現有的屬性表。頁面可以插入指定的索引處或指定的頁面之後。您可以使用這個宏，或明確傳送 PSM_INSERTPAGE 訊息。

語法

void PropSheet_InsertPage(
   hDlg,
   index,
   hpage
);

hDlg

類型： HWND

屬性表的句柄。

index

類型： HWND

要插入頁面的位置。將 wParam 設定為 NULL ，讓新頁面成為第一頁。若要指定要插入新頁面的位置，您可以傳遞索引或現有頁面的 HPROPSHEETPAGE 句柄。

值	意義
index	如果 wParam 小於 MAXUSHORT (最大無符號短整數) ，它會指定新頁面的以零起始的索引。例如，若要將插入的頁面設為屬性表上的第三頁，請將索引設定為 2。若要讓它成為第一頁，請將索引設定為 0。如果 index 的值大於頁數且小於 MAXUSHORT，則會附加頁面。
hpageInsertAfter	如果您將 wParam 設定為現有頁面的 HPROPSHEETPAGE 句柄，新頁面將會插入之後。

hpage

類型： HWND

要插入之頁面的句柄。必須先呼叫 CreatePropertySheetPage 函式來建立頁面。

無

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

屬性表不會重設大小以符合新頁面。請勿讓新頁面大於屬性表的最大頁面。

屬性表正在操作頁面清單時，會發生一些訊息和一個函數調用。當此動作發生時，嘗試修改頁面清單將會產生無法預期的結果。因此，您不應該在 PropSheetPageProc 的實作中使用 PropSheet_InsertPage 宏，或在處理下列通知和 Windows 訊息時使用。

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

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

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

注意使用 (精靈樣式 (PSH_AEROWIZARD ) 時，不支援此宏。