GUICtrlSetData
修改控件数据.
GUICtrlSetData ( controlID, data [, default] )
参数
controlID
|
使用 GUICtrlCreate...() 创建控件类函数返回的控件标识符, 或 -1 使用前面创建的控件.
|
data
|
对于 Combo(组合框), List(列表), ListView(列表视图), ListViewItem(列表视图项目):
修改 Opt("GUIDataSeparatorChar",...) 设置的项目分隔符.
对于 Progress(进度条):
修改当前进度百分比值.
对于 Slider (滑动条):
修改当前滑动值.
按钮, 复选框, 组合框, 编辑框, 群组, 输入框, 文本标签, 列表, 菜单, 菜单项, 单选框, 选项卡项目, 树视图项目:
替换控件当前显示的文本.
对于 Date(日期控件):
修改的日期或时间, 具体取决于控件样式和区域设置.
对于 Dummy(虚拟控件):
修改值.
|
default
|
[optional]
对于 Combo(组合框), List(列表): 用于显示的默认值.
对于 Edit (编辑框), Input (输入框): 若此参数设置为非空值(""), 则该字符串将被插入到当前插入符号所在点.
|
返回值
成功:
|
返回 1.
|
失败:
|
返回 0.
返回 -1, 数据无效
|
备注
对于 Combo(组合框)或 List(列表)控件 :
如果"data"为已存在的条目, 则将它设置为默认.
如果"data"以 GUIDataSeparatorChar (设置的分隔符)开始或空串 "", 则前一条列表被销毁. 一个之后的 GUIDataSeparatorChar 被忽略.
对于ListView(列表视图), ListViewItem(列表视图项目)控件 :
仅更新特定列, 其余忽略. 例如: "||update" 将更新第三列.
如果 "update" 为空值, 列/子项将被删除. 例如: "|" 将删除第2列/子项, "" 将删除第1列/子项.
对于 Monthcal(月份)控件 :
"数据"的日期格式为 "yyyy/mm/dd".
对于 Date(日期)控件:
日期和时间为区域设置定义的格式. GUICtrlRead() 使用相同的默认格式.
相关
GUICtrlCreate..., GUICtrlRead, GUICtrlUpdate..., GUIDataSeparatorChar (Option)
函数示例
#include <GUIConstantsEx.au3>
Example()
Func Example()
GUICreate("My GUI") ; will create a dialog box that when displayed is centered
GUICtrlCreateCombo("", 10, 10)
GUICtrlSetData(-1, "item1|item2|item3", "item3")
GUISetState(@SW_SHOW) ; will display an empty dialog box with a combo control with focus on
; Loop until the user exits.
While 1
Switch GUIGetMsg()
Case $GUI_EVENT_CLOSE
ExitLoop
EndSwitch
WEnd
EndFunc ;==>Example
----------------------------------------
|