PropSheet_RemovePage巨集（prsht.h）

從屬性表移除頁面。您可以使用此巨集或明確傳送 PSM_REMOVEPAGE 訊息。

語法

VOID PropSheet_RemovePage(
   HWND           hDlg,
   int            index,
   HPROPSHEETPAGE hpage
);

hDlg

類型：HWND

屬性表的句柄。

index

類型：int

要移除之頁面的以零起始的索引。

hpage

類型：HPROPSHEETPAGE

要移除之頁面的句柄。

類型：VOID

沒有傳回值。

應用程式可以將值指派給索引或 hpage，以指定要移除的頁面。如果將值指派給索引和 hpage，則 hpage 優先。

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

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

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

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

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