# Function Reference

GUICtrlSetData

Modifies the data for a control.

GUICtrlSetData ( controlID, data [, default] )

Parameters

controlID | The control identifier (controlID) as returned by a GUICtrlCreate... function.
data | For Combo, List, ListView, ListViewItem : itemtext separated with Opt("GUIDataSeparatorChar",...) For Progress : percent value For Slider : value For Group, Label, Button, Checkbox, Radio, Combo, List, Input, Edit, TabItem : text update For Date : date or time depending the style of the control For TreeViewItem: text update For Dummy : value.
default | [optional] for Combo, List : the value that will be the default. for Edit, Input : if defined and not "" the "data" string is inserted not overriding the previous value at the caret point.

Return Value

Success: | Returns 1.
Failure: | Returns 0.
| Returns -1 in case of invalid data

Remarks

For Combo or List control :
If the "data" corresponds to an already existing entry it is set as the default.
If the "data" starts with GUIDataSeparatorChar or is an empty string "" the previous list is destroyed.
For ListView, ListViewItem controls :
To update a specific column just forget about the others ie "||update" to update 3rd column.
If "update" is empty the column/subitem will be erased. For example "|" will erase the second column/subitem, "" will erase the first.

Related

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

Example

#include <GUIConstants.au3>
GUICreate("My GUI") ; will create a dialog box that when displayed is centered
GUICtrlCreateCombo ("", 10,10)
GUICtrlSetData(-1,"item1|item2|item3", "item3")
GUISetState () ; will display an empty dialog box with a combo control with focus on
; Run the GUI until the dialog is closed
While 1
$msg = GUIGetMsg()
If $msg = $GUI_EVENT_CLOSE Then ExitLoop
Wend