↑  ←  Описание функции

ControlListView

Высылает команду элементу ListView32.

ControlListView ( "title", "text", controlID, "command" [, option1 [, option2 ]] )

Параметры

title Заголовок/дескриптор/класс окна. См. заголовки и текст окон (расширенные).
text Текст окна.
controlID Идентификатор элемента управления. Смотрите Элементы управления.
command Высылаемая элементу команда (смотрите ниже). Смотрите таблицу ниже.
option1 [необязательный] Дополнительный параметр необходимый для некоторых команд.
option2 [необязательный] Дополнительный параметр необходимый для некоторых команд.

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

Действие зависит от команд указанных ниже в таблице. В случае ошибки (например, неверная команда или окно/элемент не найден) устанавливается @error = 1.


"command" [, option1 [, option2 ]] Выполняемые действия
"DeSelect", индекс начала [, индекс конца] Снимает выделение с одного или нескольких пунктов ListView.
"FindItem", "Искомая строка" [, "Номер колонки"] Возвращает индекс пункта искомой строки. Возвращает -1, если строка не найдена.
"GetItemCount" Возвращает количество пунктов (рядов) в ListView.
"GetSelected" [, параметр] Возвращает строку, содержащую индексы выделенных пунктов в ListView. Если параметр=0 (по умолчанию), то возвращается только первый из выделенных пунктов в ListView. Если параметр=1, то возвращается все выделенные пункты раздёленные символом |, например: "0|3|4|10". Если ничего не выделено, то возвращается пустая строка "".
"GetSelectedCount" Возвращает количество выделенных пунктов ListView.
"GetSubItemCount" Возвращает количество колонок.
"GetText", Номер пункта, Номер колонки Возвращает текст указанного пункта и колонки ListView.
"IsSelected", Номер пункта Если элемент выделен, то возвращает 1, иначе 0.
"Select", индекс начала [, индекс конца] Выделяет один или несколько пунктов ListView.
"SelectAll" Выделяет все пункты ListView.
"SelectClear" Снимает выделение со всех пунктов ListView.
"SelectInvert" Инвертирует выделение всех пунктов ListView.
"ViewChange", "вид" Изменяет текущий вид ListView. Правильные параметры: "list", "details", "smallicons", "largeicons" (соответственно список, таблица, маленькие и большие иконки).

Отсчёт всех пунктов и колонок начинается с 0. Это означает, что первый пункт или колонка в ListView имеет индекс 0, второй - индекс 1, и так далее.

При отображении ListView32 в виде "Details" (таблица), "пункты" можно рассматривать как "строки" а "подпункты" как "колонки".

Примечания

Некоторые команды не выполняются, когда используется 32-разрядный процесс AutoIt с применением к 64-разрядному процессу. Аналогично некоторые команды не выполняются когда используется 64-разрядный процесс AutoIt с применением к 32-разрядному процессу.

См. также

ControlCommand

Пример

; Этот пример будет правильно работать, если открыта папка AutoIt3, и в свойствах включено отображение полного пути в заголовке. Иначе необходимо указать заголовок любой открытой папки в переменную $sTitle.
$sTitle = @ProgramFilesDir & "\AutoIt3"
ControlListView($sTitle, "", "SysListView321", "SelectAll")
ControlListView($sTitle, "", "SysListView321", "Deselect", 2, 5)
MsgBox(4096, "", ControlListView($sTitle, "", "SysListView321", "GetText", 9, 0))
MsgBox(4096, "", ControlListView($sTitle, "", "SysListView321", "FindItem", "14 KB", 1))
MsgBox(4096, "", ControlListView($sTitle, "", "SysListView321", "GetSelected", 1))