基 础 函 数 参 考

GUICtrlSetData

修改控件数据.

GUICtrlSetData ( 控件ID, 数据 [, 默认值] )

参 数

控件ID 由 GUICtrlCreate... 函数返回的控件标识符.
数据 对于 Combo(组合框), List(列表), ListView(列表视图), ListViewItem(列表视图项目):
修改 Opt("GUIDataSeparatorChar",...) 设置的项目分隔符.
对于 Progress(进度条):
修改当前进度百分比值.
对于 Slider (滑动条):
修改当前滑动值.
对于 Group(群组), Label(标签), Button(按钮), Checkbox(复选框), Radio(单选框), Combo(组合框):
替换控件当前显示的文本.
对于 List(列表), Input(输入框), Edit(编辑框), TabItem(标签项目), TreeViewItem(树视图项目):
同样是替换控件当前显示的文本.
对于 Date(日期控件):
修改的日期或时间, 具体取决于控件样式和区域设置.
对于 Dummy(虚拟控件):
修改值.
默认值 [可选参数] 对于 Combo(组合框), List(列表): 用于显示的默认值.
对于 Edit (编辑框), Input (输入框): 若此参数设置为非空值(""), 则该字符串将被插入到当前插入符号所在点.

返 回 值

成功: 返回 1.
失败: 返回 0.
返回 -1, 数据无效

备 注

对于 Combo(组合框)或 List(列表)控件 :
如果"数据"为已存在的条目, 则将它设置为默认.
如果"数据"以 GUIDataSeparatorChar(设置的分隔符)开始或空串 "", 则前一条列表被销毁.

对于ListView(列表视图), ListViewItem(列表视图项目)控件 :
仅更新特定列, 其余忽略. 例如: "||update" 将更新第三列.
如果 "update" 为空值, 列/子项将被删除. 例如: "|" 将删除第二列/子项, "" 将删除第一列/子项.

对于 Monthcal(月份)控件 :
"数据"的日期格式为 "yyyy/mm/dd".

对于 Date(日期)控件:
日期和时间为区域设置定义的格式. GuiCtrlRead() 使用相同的默认格式.

相 关 函 数

GUICtrlCreate..., GUICtrlUpdate..., GUICtrlRead, GUIDataSeparatorChar (Option)

函 数 示 例


#include <GUIConstantsEx.au3>

Example()

Func Example()
    Local $msg

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

    GUICtrlCreateCombo("", 10, 10)

    GUICtrlSetData(-1, "项目 1|项目 2|项目 3", "项目 3")

    GUISetState() ; 显示一个空白的窗口, 焦点置于组合控件

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

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

provider with jb51.net (unicode)