PropSheet_AddPage宏 （prsht.h）

将新页添加到现有属性表的末尾。 可以使用此宏或显式发送 PSM_ADDPAGE 消息。

语法

BOOL PropSheet_AddPage(
   HWND           hDlg,
   HPROPSHEETPAGE hpage
);

参数

hDlg

类型：HWND

属性表的句柄。

hpage

类型：HPROPSHEETPAGE

要添加的页面的句柄。 该页必须由对 CreatePropertySheetPage 函数的上一次调用创建。

返回值

类型：BOOL

如果成功，则返回 TRUE;否则返回 FALSE。

言论

新页面不应大于属性表中当前最大的页面，因为未调整属性表的大小以适应新页面。

当属性表操作页面列表时，将发生许多消息和一个函数调用。 虽然此操作正在进行中，但尝试修改页面列表将产生不可预知的结果。 因此，不应在实现 PropSheetPageProc 或处理以下通知和Microsoft Windows 消息时使用 PropSheet_AddPage 宏：

• PSN_APPLY
• PSN_KILLACTIVE
• PSN_RESET
• PSN_SETACTIVE
• WM_DESTROY
• WM_INITDIALOG

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

要求

要求	价值
最低支持的客户端	Windows Vista [仅限桌面应用]
支持的最低服务器	Windows Server 2003 [仅限桌面应用]
目标平台	窗户
标头	prsht.h