GUICtrlCreateCheckbox
创建复选框(Checkbox)控件.
GUICtrlCreateCheckbox ( "text", left, top [, width [, height [, style = -1 [, exStyle = -1]]]] )
参数
text
|
复选框控件显示的文本.
|
left
|
控件左侧的位置. 若此值为 -1, 则根据 GUICoordMode() 的设置计算左侧位置.
|
top
|
控件上方的位置. 若此值为 -1, 则根据 GUICoordMode() 的设置计算左侧位置.
|
width
|
[可选] 控件的宽度 (默认文本自动调整适合宽度).
|
height
|
[可选] 控件的高度 (默认文本自动调整适合高度).
|
style
|
[可选] 控件的样式. 查看附录 GUI 控件样式表.
默认样式 ( -1) : $BS_AUTOCHECKBOX.
强制样式 : $WS_TABSTOP, 与 $BS_AUTOCHECKBOX, (如果未定义复选框样式时).
|
exStyle
|
[可选] 控件的扩展样式. 查看附录 扩展样式表.
|
返回值
成功:
|
返回控件标识符(控件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>
#include <MsgBoxConstants.au3>
Example()
Func Example()
; Create a GUI with various controls.
Local $hGUI = GUICreate("Example", 300, 200)
; Create a checkbox control.
Local $idCheckbox = GUICtrlCreateCheckbox("Standard Checkbox", 10, 10, 185, 25)
Local $idClose = GUICtrlCreateButton("Close", 210, 170, 85, 25)
; Display the GUI.
GUISetState(@SW_SHOW, $hGUI)
; Loop until the user exits.
While 1
Switch GUIGetMsg()
Case $GUI_EVENT_CLOSE, $idClose
ExitLoop
Case $idCheckbox
If _IsChecked($idCheckbox) Then
MsgBox($MB_SYSTEMMODAL, "", "The checkbox is checked.", 0, $hGUI)
Else
MsgBox($MB_SYSTEMMODAL, "", "The checkbox is not checked.", 0, $hGUI)
EndIf
EndSwitch
WEnd
; Delete the previous GUI and all controls.
GUIDelete($hGUI)
EndFunc ;==>Example
Func _IsChecked($idControlID)
Return BitAND(GUICtrlRead($idControlID), $GUI_CHECKED) = $GUI_CHECKED
EndFunc ;==>_IsChecked
----------------------------------------
|