GUICtrlRead
Возвращает состояние или текст элемента управления.
GUICtrlRead ( controlID [, advanced = 0 ] )
Параметры
controlID | Идентификатор элемента управления, возвращаемый функциями GUICtrlCreate.... |
advanced |
[необязательный] Возвращает расширенную информацию элемента управления. 0 = (по умолчанию) Возвращает значение состояния или данные элемента управления. 1 = Возвращает расширенную информацию элемента управления. |
Возвращаемое значение
Успех: | Возвращает в зависимости от типа элемента управления (смотрите ниже). |
Ошибка: | Возвращает 0. |
Элемент | Возвращаемое значение при флаге advanced = 0 |
---|---|
Button | Текст, отображаемый на кнопке |
Checkbox, Radio | Состояние элемента. Смотрите таблицу состояния элементов |
Combo, List | Текст выбранного пункта |
Dummy | Величина установленная с помощью GUICtrlSendToDummy() или GUICtrlSetData() |
Input, Edit | Текст, содержащийся в элементе |
Date | Выбранную дату в формате определяемом региональными настройками |
ListView | Идентификатор выбранного пункта в ListView. Или 0, если ничего не выбрано. |
ListViewItem | Текст выбранного пункта / строки в ListView. Или 0, если ничего не выбрано. |
Menu, MenuItem | Состояние пункта. Смотрите таблицу состояния элементов |
Progress | Текущий процент прогресса |
Slider | Текущее значение ползунка |
Tab | Номер вкладки, отсчёт от 0. |
TreeView | Идентификатор выбранного пункта в TreeView. |
TreeViewItem | Состояние указанного пункта. |
Элемент | Возвращаемое значение при флаге advanced = 1 |
---|---|
Checkbox, Radio | Текст, отображаемый на элементе. |
ListViewItem | Состояние пункта, если используется стиль $LVS_EX_CHECKBOXES. Смотрите таблицу состояния элементов |
Menu, MenuItem | Текст, отображаемый на пункте. |
Tab | Идентификатор выбранной вкладки. |
TreeView | Текст выбранного пункта в TreeView. |
TreeViewItem | Текст указанного пункта. |
Примечания
Для элементов Checkbox, Radio устанавливается несколько состояний и могут возвращаться $GUI_CHECKED и $GUI_UNCHECKED. Для Checkbox ещё третье состояние $GUI_INDETERMINATE.См. также
GUICtrlUpdate..., GUIGetMsg, GUICtrlSetData, GUIEventOptions (Опция), GUICtrlCreate..., GUICtrlGetState, GUICtrlSendToDummy, GUICtrlSendMsgПример
#include <GUIConstantsEx.au3>
Example()
Func Example()
Local $iMenu, $iList, $iBtnRead, $msg, $iMenuState, $sMenuText, $hGui
$hGui = GUICreate("GUICtrlRead") ; Создаёт окно в центре экрана
$iMenu = GUICtrlCreateMenu("Файл")
$iList = GUICtrlCreateList("", 10, 10, -1, 100)
GUICtrlSetData(-1, "Пункт1|Пункт2|Пункт3", "Пункт2")
$iBtnRead = GUICtrlCreateButton("Чтение", 140, 110, 70)
GUICtrlSetState(-1, $GUI_FOCUS) ; устанавливает фокус на кнопку
GUISetState() ; показывает созданное окно
; Запускается цикл опроса GUI до тех пор пока окно не будет закрыто
Do
$msg = GUIGetMsg()
If $msg = $iBtnRead Then
MsgBox(0, "Выбранный пункт ListBox", GUICtrlRead($iList), 0, $hGui) ; Отображает выбранный пункт ListBox
$iMenuState = GUICtrlRead($iMenu) ; возвращает состояние пункта меню
$sMenuText = GUICtrlRead($iMenu, 1) ; возвращает текст пункта меню
MsgBox(0, "Состояние и текст пункта меню", "состояние: " & $iMenuState & @LF & "текст меню: " & $sMenuText, 0, $hGui)
EndIf
Until $msg = $GUI_EVENT_CLOSE
EndFunc