函数说明

GUICtrlCreateCheckbox

在GUI上创建一个复选框(Checkbox)控件。

GUICtrlCreateCheckbox ( "文本", 左侧, 上方 [, 宽度 [, 高度 [, 风格 [, 扩展风格]]]] )

 

参数

文本 控件的文本。
左侧 控件左侧的位置。若此值为 -1 则根据 GUICoordMode 的设置来计算左侧位置。
上方 控件上方的位置。若此值为 -1 则根据 GUICoordMode 的设置来计算上方位置。
宽度 [可选参数] 控件的宽度(默认值为上一个控件的宽度)。
高度 [可选参数] 控件的高度(默认值为上一个控件的高度)。
风格 [可选参数] 指定控件的风格。请查看附录中关于 GUI 控件风格 的说明。

默认值(-1):非强制性风格:$WS_TABSTOP, $BS_AUTOCHECKBOX
扩展风格 [可选参数] 指定控件的扩展风格。请查看附录的 扩展风格表

 

返回值

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

 

注意

若要获得控件的各种值请查看 GUICtrlRead.
若要设置或修改控件的各种信息请查看 GUICtrlSet....

使用 $BS_ICON 或 $BS_BITMAPA 风格即可让复选框显示一个图标或图片。使用 GUICtrlSetImage 来指定图片文件。

要在默认风格的基础上添加一个新的风格可使用 BitOr($GUI_SS_DEFAULT_CHECKBOX, 新风格,...)。

 

相关

GUICoordMode(选项), GUICtrlSet..., GUIGetMsg

 

示例


#include <GUIConstants.au3>

GUICreate("我的 GUI 之Checkbox")  ; 创建一个居中显示的窗口

$checkCN = GUICtrlCreateCheckbox ("CHECKBOX 1", 10, 10, 120, 20)

GUISetState ()       ; 显示一个带有一个复选按钮的窗口

; 运行脚本直到窗口被关闭
While 1
    $msg = GUIGetMsg()
   
    If $msg = $GUI_EVENT_CLOSE Then ExitLoop
Wend