# Funktionsreferenz

GUICtrlCreateListView

Erstellt eine Liste mit mehreren Spalten für die GUI.

GUICtrlCreateListView ( "text", left, top [, width [, height [, style [, exStyle]]]] )

Parameter

text | Definition der Spaltenüberschriften.
left | Die linke Seite des Steuerelements. Wird -1 verwendet, dann wird left mit Hilfe von GUICoordMode berechnet.
top | Die Oberkante des Steuerelements. Wird -1 verwendet, dann wird top mit Hilfe von GUICoordMode berechnet.
width | [optional] Die Breite des Steuerelements (voreingestellt ist die zuvor verwendete Breite).
height | [optional] Die Höhe des Steuerelements (voreingestellt ist die zuvor verwendete Höhe).
style | [optional] Legt den Stil des Steuerelements fest. Siehe Appendix "GUI Control"-Stile. Standard (-1) : $LVS_SHOWSELALWAYS, $LVS_SINGLESEL Erzwungene Stile : $LVS_REPORT
exStyle | [optional] Legt den erweiterten Stil des Steuerelements fest. Siehe Tabelle der erweiterten Stile.

Bemerkungen

Um dem Steuerelement Listeneinträge hinzuzufügen verwende GUICtrlCreateListViewItem
Die Spalten-Liste wird immer so aussehen wie die "Detail"-Ansicht des Explorers (LVS_REPORT Stil wird erzwungen).
Du kannst die anfängliche Spaltenbreite kontrollieren, indem du Leerzeichen in die Spaltenüberschriften einfügst. Die Spaltenbreite kann durch GUICtrlCreateListViewItem auf die Breite der Einträge erweitert werden. Bis zu etwa 25 Zeichen passen in eine Spalte. Werden die Einträge durch GUICtrlSetDate verändert, wird keine Größenanpassung vorgenommen.
Andere Ansichten der Liste und das Sortieren der Listeneinträge durch Klick auf die Spaltenüberschriften (wie im Explorer) sind zur Zeit noch nicht implementiert.
Um eine ganze Zeile durch einen Farbbalken auszuwählen verwende den erweiterten Stil LVS_EX_FULLROWSELECT.
Um weitere Stile zusätzlich zum Standardstil zu verwenden benutze BitOr($GUI_SS_DEFAULT_LISTVIEW, newstyle,...).

Siehe auch

GUICtrlCreateListViewItem, GUICoordMode (Option), GUICtrlSetData, GUIGetMsg

Beispiel

#include <GUIConstants.au3>
GUICreate("listview items",220,250, 100,200,-1,$WS_EX_ACCEPTFILES)
GUISetBkColor (0x00E0FFFF) ; will change background color
$listview = GUICtrlCreateListView ("col1 |col2|col3 ",10,10,200,150);,$LVS_SORTDESCENDING)
$button = GUICtrlCreateButton ("Value?",75,170,70,20)
$item1=GUICtrlCreateListViewItem("item2|col22|col23",$listview)
$item2=GUICtrlCreateListViewItem("item1|col12|col13",$listview)
$item3=GUICtrlCreateListViewItem("item3|col32|col33",$listview)
$input1=GUICtrlCreateInput("",20,200, 150)
GUICtrlSetState(-1,$GUI_ACCEPTFILES) ; to allow drag and dropping
GUISetState()
GUICtrlSetData($item2,"ITEM1",)
GUICtrlSetData($item3,"||COL33",)
GUICtrlDelete($item1)
Do
$msg = GUIGetMsg ()
Select
Case $msg = $button
MsgBox(0,"listview item",GUICtrlRead(GUICtrlRead($listview)),2)
Case $msg = $listview
MsgBox(0,"listview", "clicked="& GUICtrlGetState($listview),2)
EndSelect
Until $msg = $GUI_EVENT_CLOSE