导航:  Windows Controls Wrapper Functions > Property Sheet Control > Wrappers >

PropSheet_InsertPage

上一页返回章节概述下一页

描述

 

在现有的属性表中插入一个新的页面。

 

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