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