PropSheet_InsertPage宏 (prsht.h)

将新页插入现有属性表。该页可以插入到指定的索引处，也可以插入到指定的页之后。可以使用此宏或显式发送 PSM_INSERTPAGE 消息。

语法

void PropSheet_InsertPage(
   hDlg,
   index,
   hpage
);

hDlg

类型： HWND

属性表的句柄。

index

类型： HWND

要插入页面的位置。将 wParam 设置为 NULL ，使新页面成为第一页。若要指定新页面的插入位置，可以传递索引或现有页面的 HPROPSHEETPAGE 句柄。

值	含义
index	如果 wParam 小于 MAXUSHORT (最大无符号短整数) ，它将为新页指定从零开始的索引。例如，若要使插入页成为属性表上的第三页，请将索引设置为 2。若要将其设为第一页，请将索引设置为 0。如果 index 的值大于页数且小于 MAXUSHORT，则将追加该页。
hpageInsertAfter	如果将 wParam 设置为现有页面的 HPROPSHEETPAGE 句柄，则会在其后面插入新页面。

hpage

类型： HWND

要插入的页面的句柄。必须先通过调用 CreatePropertySheetPage 函数来创建页面。

无

插入点后面的页面将移到右侧以适应新页面。

不会调整属性表的大小以适应新页面。不要使新页大于属性表的最大页。

当属性表操作页面列表时，会发生大量消息和一个函数调用。在执行此操作时，尝试修改页面列表将产生不可预知的结果。因此，不应在 PropSheetPageProc 的实现中或在处理以下通知和 Windows 消息时使用 PropSheet_InsertPage 宏。

如果你在处理其中一条消息或 PropSheetPageProc 正在运行时需要修改属性表页，请向自己发布一条专用 Windows 消息。应用程序在属性表管理器完成任务之前不会收到该消息。然后，可以修改页面列表。

以下通知也受属性表修改的影响。

可以添加或删除页面以响应这些通知，前提是通过DWL_MSGRESULT) 非零值返回 (以指定所需的新页面。但请注意，如果插入位于当前页面前的页面 (索引小于当前页) ，则PSN_KILLACTIVE 可能会发送到错误的页面。

注意使用 Aero 向导样式 (PSH_AEROWIZARD) 时，不支持此宏。