描述
在现有的属性表中插入一个新的页面。
PB语法
FUNCTION PropSheet_InsertPage ( _ BYVAL hDlg AS DWORD, _ BYVAL index AS LONG, _ BYVAL hpage AS DWORD _ ) AS LONG |
参数
hDlg |
[in]处理属性表。 |
index |
[in]页面的插入位置。
index 如果index参数小于MAXUSHORT(最大无符号短整数),则index指定新页面的基于零的索引。 hpageInsertAfter 如果将index参数设置为现有页面的HPROPSHEETPAGE句柄,则将在其后插入新页面。 |
hPage |
[in]处理要插入的页面。 |
返回值
如果页面成功插入,则返回非零值,否则返回0。
备注
插入点后的页面向右移动以容纳新页面。
属性表未调整大小以适应新页面。
在属性表处理页面列表时,会发生一些消息和一个函数调用。
· | PSN_APPLY |
· | PSN_KILLACTIVE |
· | PSN_RESET |
· | PSN_SETACTIVE |
· | WM_DESTROY |
· | WM_INITDIALOG |
如果您在处理这些消息之一或PropSheetPageProc正在运行时需要修改属性表页面,请张贴私人Windows消息。
以下通知也受属性表修改的影响。
· | PSN_WIZBACK |
· | PSN_WIZNEXT |
您可以添加或删除页面以响应这些通知,前提是通过DWL_MSGRESULT返回非零值以指定所需的新页面。
注意 使用Aero向导样式(PSH_AEROWIZARD)时不支持此消息。
最低操作系统
Windows 2000,Windows NT 4.0与Internet Explorer 5,Windows 98。
引用文件 #INCLUDE Once
Prsht.inc