Функция GUICtrlSetData

GUICtrlSetData

Изменение параметров элемента.

GUICtrlSetData ( controlID, data [, default ] )

Параметры

controlID	Идентификатор элемента возвращаемый функцией GUICtrlCreate....
data	Для Combo, List, ListView, ListViewItem: устанавливает список пунктов с разделителем Opt("GUIDataSeparatorChar",...). Для Progress: устанавливает прогресс в процентах. Для Slider: устанавливает значение ползунка. Для Group, Label, Button, Checkbox, Menu, MenuItem, Radio, Combo, List, Input, Edit, TabItem, TreeViewItem: заменяет текст. Для Date : устанавливает дату или время в зависимости от стиля элемента и региональных установок. Для Dummy: устанавливает значение.
default	[необязательный] Для Combo, List: значение из списка, которое будет выбрано по умолчанию. Для Edit, Input: если это значение не пустая строка, то данные вставляется в текущую позицию (где установлен курсор) или заменяет выделенное.

Возвращаемое значение

Успех:	Возвращает 1.
Ошибка:	Возвращает 0.
	Возвращает -1 в случае неверных данных

Примечания

Для элементов Combo или List :
Если data уже содержатся в элементе, то эти данные становятся текущими по умолчанию.
Если data начинаются с разделителя (GUIDataSeparatorChar) или пустой строки ("") то предыдущий список удаляется.
Если data не содержатся в элементе, но требуется добавить и сделать текущими, то используйте GUICtrlSetData ( $controlID, "data" , "data" )

Для элементов ListView, ListViewItem :
Для обновления определённой колонки просто забыть о других т.е. "| | Обновление" для обновления 3-ей колонки.
Если обновление выполняется пустотой, то колонка / подпункт будет стёрт. Для примера "|" очистит вторую колонку / подпункт.

Для элементов Monthcal :
Формат даты в data - "yyyy/mm/dd".

Для элементов Date :
Дата и время в формате, который определён региональными установками. GuiCtrlRead() использует этот же формат по умолчанию.

Для элементов Edit :
При вставке data новые данные заменяет предыдущие. Чтобы data дописывались в конец предыдущих данных, добавьте в параметр default любое значение, например 1.

См. также

GUICtrlCreate..., GUICtrlUpdate..., GUICtrlRead, GUIDataSeparatorChar (Опция)

Пример

#include <GUIConstantsEx.au3>

Example()

Func Example()
Local $msg

GUICreate("Вставляет данные") ; Создаёт окно в центре экрана
GUICtrlCreateCombo("", 10, 10)
GUICtrlSetData(-1, "Пункт1|Пункт2|Пункт3", "Пункт3") ; -1 последняя использованная переменная
GUISetState() ; показывает созданное окно с установленным фокусом на Combo

; Запускается цикл опроса GUI до тех пор пока окно не будет закрыто
While 1
$msg = GUIGetMsg()

If $msg = $GUI_EVENT_CLOSE Then ExitLoop
WEnd
EndFunc