PSM_INSERTPAGE消息

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

参数

wParam

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

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

lParam

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

如果成功插入页面，则返回非零值，否则返回零值。

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

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

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

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

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

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

注意

使用 Aero 向导样式 (PSH_AEROWIZARD ) 时，不支持此消息。