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 | [optional] Additional parameter required by some commands. |
option2 | [optional] Additional parameter required by some commands. |
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.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". |
Remarks
None.
Related
ControlCommand, ControlDisable, ControlEnable, ControlFocus, ControlGetPos, ControlGetText, ControlHide, ControlClick, ControlMove, ControlSetText, ControlShow, StatusbarGetText, WinMenuSelectItem, WinGetClassList
Example
ControlListView("C:\Program Files\NSIS", "", "SysListView321", "SelectAll")
ControlListView("C:\Program Files\NSIS", "", "SysListView321", "Deselect", 2, 5)
MsgBox(0, "", ControlListView("C:\Program Files\NSIS", "", "SysListView321", "GetText", 9, 0) )
MsgBox(0, "", ControlListView("C:\Program Files\NSIS", "", "SysListView321", "FindItem", "14 KB", 1) )
MsgBox(0, "", ControlListView("C:\Program Files\NSIS", "", "SysListView321", "GetSelected", 1) )