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）时不支持此宏。