基 础 函 数 参 考

GUICtrlCreateCheckbox

创建复选框(Checkbox)控件.

GUICtrlCreateCheckbox ( "文本", 左距, 顶距 [, 宽度 [, 高度 [, 样式 [, 扩展样式]]]] )

参 数

文本 复选框控件显示的文本.
左距 控件左侧的位置. 若此值为 -1, 则根据 GUICoordMode 的设置计算左侧位置.
顶距 控件上方的位置. 若此值为 -1, 则根据 GUICoordMode 的设置计算左侧位置.
宽度 [可选参数] 控件的宽度 (默认文本自动调整适合宽度).
高度 [可选参数] 控件的高度 (默认文本自动调整适合高度).
样式 [可选参数] 控件的样式. 查看附录 GUI 控件样式表.

默认样式 ( -1) : $BS_AUTOCHECKBOX.
强制样式 : $WS_TABSTOP, 与 $BS_AUTOCHECKBOX, 不定义复选框样式.
扩展样式 [可选参数] 控件的扩展样式. 查看附录 扩展样式表.

返 回 值

成功: 返回控件标识符(控件ID).
失败: 返回 0.

备 注

要获得控件的值, 查看 GUICtrlRead.
设置或者修改控件信息, 参考 GUICtrlUpdate....

使用 $BS_ICON 或 $BS_BITMAP 样式即可让复选框显示一个图标或图片.使用 GUICtrlSetImage 指定图片文件.

要在默认样式上添加新样式, 可使用 BitOr($GUI_SS_DEFAULT_CHECKBOX, 新样式,...) 语句.

使用上面列出的值必须将 #include <ButtonConstants.au3> 语句写入脚本中.

默认(default)大小: $GUI_DOCKHEIGHT.

相 关 函 数

GUICoordMode (Option), GUICtrlUpdate..., GUIGetMsg

函 数 示 例


#include <GUIConstantsEx.au3>

Example()

Func Example()
    Local $msg
    GUICreate("我的复选框 GUI") ; 创建居中显示的 GUI 窗口

    GUICtrlCreateCheckbox("复选框 1", 10, 10, 120, 20)

    GUISetState() ; 显示有复选框控件的 GUI

    ; 运行 GUI, 直到 GUI 被关闭
    While 1
        $msg = GUIGetMsg()

        If $msg = $GUI_EVENT_CLOSE Then ExitLoop
    WEnd
EndFunc   ;==>Example

provider with jb51.net (unicode)