描述
将新页插入现有属性表中.可以在指定索引或指定页后插入该页.您可以使用此功能或明确的把PSM_INSERTPAGE消息.
FreeBASIC 语法
#define PropSheet_InsertPage(hDlg, index, hpage) |
参数
hDlg |
[in]属性表控件的句柄 |
index |
[in]在页面被插入.此参数设置为NULL作出新的页面的第一页.指定在新页面被插入,你可以通过一个指标或现有的网页的HPROPSHEETPAGE句柄.
index 如果index参数小于MAXUSHORT（最大无符号短整数）,然后index指定下标的新的一页.例如,要在属性表中插入插入页的第三页,将索引设置为2.要使之成为第一页,设置索引为0.如果指数有一个值大于和小于MAXUSHORT,网页页面将追加数. hpageInsertAfter 如果你设置index参数到一个现有的网页的HPROPSHEETPAGE句柄,新的页面将被插入后. |
hPage |
[in]处理页面被插入.网页必须首先被调用的函数创建的CreatePropertySheetPage. |
返回值
如果页成功插入,则返回非零值,否则为零.
备注
插入点后的页移到右侧以容纳新页.
属性表不调整大小以适应新的页面.不要使新页大于属性页的最大页.
属性页正在操作页列表时会出现多条消息和一个函数调用.虽然这一行动正在发生,试图修改页面列表将有不可预知的结果.因此,你不应该使用PropSheet_InsertPage消息在你实现PropSheetPageProc或同时处理以下通知和微软Windows消息.
| · | PSN_APPLY |
| · | PSN_KILLACTIVE |
| · | PSN_RESET |
| · | PSN_SETACTIVE |
| · | WM_DESTROY |
| · | WM_INITDIALOG |
如果你需要在你处理这些消息之一或同时PropSheetPageProc运行中修改一个属性页,后自己私人的Windows消息.直到属性表管理器完成任务后,应用程序才会收到该消息.然后你可以修改页面列表.
下列通知也受属性表修改的影响.
| · | PSN_WIZBACK |
| · | PSN_WIZNEXT |
您可以添加或删除在回应这些通知页面,只要你回报（通过DWL_MSGRESULT)非零值指定所需的新的一页.请注意,但是,如果你插入网页,坐落在当前页面（有一个比当前页面较小的指标）,PSN_KILLACTIVE可能被发送到错误的页面.
注意,这个信息是不使用航空向导式的支持时（PSH_AEROWIZARD）.
引用文件
Prsht.bi