PropSheet_AddPage宏 (prsht.h)

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

语法

void PropSheet_AddPage(
   hDlg,
   hpage
);

参数

hDlg

类型: HWND

属性表的句柄。

hpage

类型: HPROPSHEETPAGE

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

返回值

备注

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

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

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

要求

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