PropSheet_InsertPage巨集（prsht.h）

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

語法

BOOL PropSheet_InsertPage(
   HWND hDlg,
   HWND index,
   HWND hpage
);

hDlg

類型：HWND

屬性表的句柄。

index

類型：HWND

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

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

hpage

類型：HWND

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

類型：BOOL

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

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

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

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

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

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

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

附注使用航空精靈樣式時不支援此巨集（PSH_AEROWIZARD）。