Функция 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