描述
向窗口添加控件。
PowerBasic 语法(Ansi版)
METHOD AddControl ( _ BYVAL strClassName AS STRING, _ BYVAL hParent AS DWORD, _ BYVAL cID AS LONG, _ BYVAL strTitle AS STRING, _ BYVAL x AS LONG, _ BYVAL y AS LONG, _ BYVAL nWidth AS LONG, _ BYVAL nHeight AS LONG, _ OPTIONAL BYVAL dwStyle AS DWORD, _ OPTIONAL BYVAL dwExStyle AS DWORD, _ OPTIONAL BYVAL lpParam AS DWORD, _ OPTIONAL BYVAL pWndProc AS DWORD, _ OPTIONAL BYVAL bNoScale AS LONG _ ) AS DWORD |
PowerBasic 语法(Unicode版)
METHOD AddControl ( _ BYVAL strClassName AS WSTRING, _ BYVAL hParent AS DWORD, _ BYVAL cID AS LONG, _ BYVAL strTitle AS WSTRING, _ BYVAL x AS LONG, _ BYVAL y AS LONG, _ BYVAL nWidth AS LONG, _ BYVAL nHeight AS LONG, _ OPTIONAL BYVAL dwStyle AS DWORD, _ OPTIONAL BYVAL dwExStyle AS DWORD, _ OPTIONAL BYVAL lpParam AS DWORD, _ OPTIONAL BYVAL pWndProc AS DWORD, _ OPTIONAL BYVAL bNoScale AS LONG _ ) AS DWORD |
参数
strClassName |
[in]窗口类名。 类名可以是RegisterClass或RegisterClassEx注册的任何名称,前提是注册该类的模块也是创建窗口的模块。 类名也可以是任何预定义的系统类名。 |
hParent |
[in]正在创建控件的父窗体或所有者窗口的句柄。 |
cID |
[in]控件标识符,用于通知其父项关于事件的整数值。 应用程序确定控制标识符; 对于具有相同父窗口的所有控件,它必须是唯一的。 |
strTitle |
[in]窗口名称。 如果窗口样式指定标题栏,则标题栏将显示窗口标题。 创建控件(如按钮,复选框和静态控件)时,请使用strTitle指定控件的文本。 使用SS_ICON风格创建静态控件时,请使用strTitle指定图标名称或标识符。 要指定标识符,请使用语法“#num”。 |
x |
[in]窗口左上角的x坐标相对于父窗口的客户区域的左上角。 |
y |
[in]窗口左上角相对于父窗口客户区域左上角的初始y坐标。 |
nWidth |
[in]窗口的宽度。 |
nHeight |
[in]窗口的高度。 |
dwStyle |
[in]正在创建的窗口的样式。 |
dwExStyle |
[in]正在创建的控件的扩展窗口样式。 |
lpParam |
[in, opt]通过WM_CREATE消息lParam参数指向的CREATESTRUCT结构(lpCreateParams成员)指向要传递到窗口的值。 此消息在返回之前通过此函数发送到创建的窗口。 |
pWndProc |
[in, opt]窗口回调过程的地址。 |
bNoScale |
[in, opt]不要缩放控件。 |
返回值
如果方法成功,则返回值是新窗口的句柄。
如果方法失败,返回值为NULL。 要获取扩展错误信息,请调用GetLastError.
此方法通常由于以下原因之一而失败:
· | 参数值无效 |
· | 系统类由不同的模块注册 |
· | 安装了WH_CBT钩子并返回故障代码 |
· | 如果对话框模板中的一个控件未注册,或者其窗口窗口过程失败WM_CREATE或WM_NCCREATE. |
Styles
此控件使用的默认样式是WS_CHILD OR WS_VISIBLE OR WS_TABSTOP
引用文件 #INCLUDE Once
CWindow.inc