ControlListView
Beschreibung anzeigen in
Sendet einen Befehl an ein ListView32 Control.
ControlListView ( "title", "text", controlID, "command" [, option1 [, option2]] )
Parameter
| title | Der Titel des Fensters, auf das zugegriffen werden soll. Siehe spezielle Titeldefinition. |
| text | Der Text des Fensters, auf das zugegriffen werden soll. Siehe spezielle Textdefinition. |
| ControlID | Die ID des Controls, das beeinflusst werden soll. Siehe Controls. |
| command | Der Befehl, der an das Control gesendet wird (siehe unten). |
| option1 | [optional] Zusätzlicher Parameter soweit der Befehl es erfordert. |
| option2 | [optional] Zusätzlicher Parameter soweit der Befehl es erfordert. |
Rückgabewert
Der Rückgabewert hängt von den unten angeführten Befehlen ab. Tritt ein Fehler auf - etwa "ungültiger Befehl" oder "Fenster, Control wurde nicht gefunden" - dann wird @error = 1 gesetzt.| Befehl, Option1, Option2 | Operation |
| "DeSelect", From [, To] | Abwählen eines oder mehrerer Items, von [,bis]. |
| "FindItem", "string to find" [, SubItem] | Gibt den Element-Index des zu findenden Strings zurück. Gibt -1 zurück, falls der String nicht gefunden wurde. |
| "GetItemCount" | Gibt die Anzahl der Items in der Liste zurück. |
| "GetSelected" [, option] | Gibt einen String zurück, die die Indizes aller gewählten Items enthält. Ist die Option=0 (Standard), wird nur der Index des ersten gewählten Items zurückgegeben. Ist die Option=1, werden die Indizes aller gewählten Items zurückgegeben, getrennt durch |, z.B: "0|3|4|10". Ist kein Element der Liste ausgewählt, wird ein leerer String "" zurückgegeben. |
| "GetSelectedCount" | Gibt die Anzahl der gewählten Items zurück. |
| "GetSubItemCount" | Gibt die Anzahl der Child-Items zurück. |
| "GetText", Item, SubItem | Gibt den Text eines items/Child-Items zurück. |
| "IsSelected", Item | Gibt 1 zurück, wenn das Element ausgewählt ist, ansonsten 0. |
| "Select", From [, To] | Auswählen eines oder mehrerer Items, von [,bis]. |
| "SelectAll" | Auswählen aller Items. |
| "SelectClear" | Löscht die Auswahl aller Items. |
| "SelectInvert" | Invertiert die aktuelle Auswahl. |
| "ViewChange", "view" | Wechselt die aktuelle Ansicht. Gültige "views"(=Ansichtsoptionen) sind "list", "details", "smallicons", "largeicons". |
Alle items und Child-Items basieren auf 0. Das heißt, dass das erste item/Child-Item in einer Liste gleich 0 ist, das zweite ist 1 und so weiter.
In einer detaillierten Ansicht des ListView32 Controls kann das "item" als "Zeile" aufgefasst werden und das "Child-Item" als "Spalte".
Bemerkungen
Manche Befehle funktionieren nicht, wenn ein 32-bit AutoIt Prozess verwendet wird, um von einem 64-Bit Prozess zu lesen. Genauso können Befehle nicht funktionieren, wenn ein 64-bit AutoIt Prozess verwendet wird, um von einem 32-bit Prozess zu lesen.
Verwandte Funktionen
Beispiel
#include <MsgBoxConstants.au3>
ControlListView(@ProgramFilesDir & "\AutoIt3", "", "SysListView321", "SelectAll")
ControlListView(@ProgramFilesDir & "\AutoIt3", "", "SysListView321", "Deselect", 2, 5)
MsgBox($MB_SYSTEMMODAL, "", ControlListView(@ProgramFilesDir & "\AutoIt3", "", "SysListView321", "GetText", 9, 0))
MsgBox($MB_SYSTEMMODAL, "", ControlListView(@ProgramFilesDir & "\AutoIt3", "", "SysListView321", "FindItem", "14 KB", 1))
MsgBox($MB_SYSTEMMODAL, "", ControlListView(@ProgramFilesDir & "\AutoIt3", "", "SysListView321", "GetSelected", 1))