PropSheet_InsertPage宏 (prsht.h)
将新页插入现有属性表。 该页可以插入到指定的索引处,也可以插入到指定的页之后。 可以使用此宏或显式发送 PSM_INSERTPAGE 消息。
语法
void PropSheet_InsertPage(
hDlg,
index,
hpage
);
参数
hDlg
类型: HWND
属性表的句柄。
index
类型: HWND
要插入页面的位置。 将 wParam 设置为 NULL ,使新页面成为第一页。 若要指定新页面的插入位置,可以传递索引或现有页面的 HPROPSHEETPAGE 句柄。
hpage
类型: HWND
要插入的页面的句柄。 必须先通过调用 CreatePropertySheetPage 函数来创建页面。
返回值
无
备注
插入点后面的页面将移到右侧以适应新页面。
不会调整属性表的大小以适应新页面。 不要使新页大于属性表的最大页。
当属性表操作页面列表时,会发生大量消息和一个函数调用。 在执行此操作时,尝试修改页面列表将产生不可预知的结果。 因此,不应在 PropSheetPageProc 的实现中或在处理以下通知和 Windows 消息时使用 PropSheet_InsertPage 宏。
如果你在处理其中一条消息或 PropSheetPageProc 正在运行时需要修改属性表页,请向自己发布一条专用 Windows 消息。 应用程序在属性表管理器完成任务之前不会收到该消息。 然后,可以修改页面列表。以下通知也受属性表修改的影响。
可以添加或删除页面以响应这些通知,前提是通过DWL_MSGRESULT) 非零值返回 (以指定所需的新页面。 但请注意,如果插入位于当前页面前的页面 (索引小于当前页) , 则PSN_KILLACTIVE 可能会发送到错误的页面。要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | prsht.h |