PropSheet_RemovePage宏 (prsht.h)

從屬性工作表移除頁面。您可以使用此宏，或明確傳送 PSM_REMOVEPAGE 訊息。

語法

void PropSheet_RemovePage(
   hDlg,
   index,
   hpage
);

hDlg

類型： HWND

屬性表的句柄。

index

類型： int

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

hpage

類型： HPROPSHEETPAGE

要移除之頁面的句柄。

無

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

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

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

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

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

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