Method Reference
ControlListView
Sends a command to a ListView32 control
ControlListView "title", "text", "controlID", "command", "option1", "option2"
Parameters
| title | The title of the window to access. |
| text | The text of the window to access. |
| controlID | The control to interact with. See Controls. |
| command | The command to send to the control (see below). |
| option1 | Additional parameter required by some commands; use "" if parameter is not required. |
| option2 | Additional parameter required by some commands; use "" if parameter is not required. |
Return Value
Depends on command as table below shows. In case of an error (such as an invalid command or window/control could not be found) then @error is set to 1.All items/subitems are 0 based. This means that the first item/subitem in a list is 0, the second is 1, and so on.
In a "Details" view of a ListView32 control, the "item" can be thought of as the "row" and the "subitem" as the "column".
| Command, Option1, Option2 | Operation |
| "DeSelect", From [, To] | Deselects one or more items. |
| "FindItem", "string to find" [, SubItem] | Returns the item index of the string. Returns -1 if the string is not found. |
| "GetItemCount" | Returns the number of list items. |
| "GetSelected" [, option] | Returns a string containing the item index of selected items. If option=0 (default) only the first selected item is returned. If option=1 then all the selected items are returned delimited by |, e.g: "0|3|4|10". If no items are selected a blank "" string is returned. |
| "GetSelectedCount" | Returns the number of items that are selected. |
| "GetSubItemCount" | Returns the number of subitems. |
| "GetText", Item, SubItem | Returns the text of a given item/subitem. |
| "IsSelected", Item | Returns 1 if the item is selected, otherwise returns 0. |
| "Select", From [, To] | Selects one or more items. |
| "SelectAll" | Selects all items. |
| "SelectClear" | Clears the selection of all items. |
| "SelectInvert" | Inverts the current selection. |
| "ViewChange", "view" | Changes the current view. Valid views are "list", "details", "smallicons", "largeicons". |
Related
ControlClick, ControlCommand, ControlDisable, ControlEnable, ControlFocus, ControlGetPosX, ControlGetPosY, ControlGetText, ControlHide, ControlMove, ControlSetText, ControlShow, ControlTreeView, StatusbarGetText, WinGetClassList, WinMenuSelectItem
Example
Set oAutoIt = WScript.CreateObject("AutoItX3.Control") oAutoIt.ControlListView "C:\Program Files\NSIS", "", "SysListView321", "SelectAll", "", "" oAutoIt.ControlListView "C:\Program Files\NSIS", "", "SysListView321", "Deselect", "2", "5"