_GUICtrlListView_SetItem
Beschreibung anzeigen in
Setzt manche oder alle Attribute eines Items
#include <GuiListView.au3>
_GUICtrlListView_SetItem ( $hWnd, $sText [, $iIndex = 0 [, $iSubItem = 0 [, $iImage = -1 [, $iParam = -1 [, $iIndent = -1]]]]] )
Parameter
| $hWnd | Control-ID / Handle des Controls |
| $sText | Itemtext. Siehe Bemerkungen |
| $iIndex | [optional] 0-basierender Index des Items |
| $iSubItem | [optional] 1-basierender Index des Subitems oder 0, falls es sich auf ein Item bezieht |
| $iImage | [optional] 0-basierender Index des Icons des Items in der Imagelist des Controls |
| $iParam | [optional] Wert für das Item |
| $iIndent | [optional] Anzahl von Bilderbreiten, die das Item eingerückt werden soll. Eine einfache Einrückung entspricht der Breite eines Bildes. |
Rückgabewert
| Erfolg: | True |
| Fehler: | False |
Bemerkungen
Falls ein Benachrichtigungs-Callback benötigt wird, so ist $sText = -1 (LPSTR_TEXTCALLBACK) festzulegen.
Da AutoIt den $iParam Parameter verwendet um die ControlID von native erstellten ListView Items zu speichern, sollte dieser Wert ausreichend groß genug sein für UDF-erstellte Items. Dies verhindert einen Konflikt mit anderen existierenden Controls. Ein Startwert von 1000 wird empfohlen.
- - - - - - - - Erklärung der Controls - - - - - - - -
Verwandte Funktionen
_GUICtrlListView_GetItem, _GUICtrlListView_SetItemEx
Beispiel
#include <GUIConstantsEx.au3>
#include <GuiListView.au3>
#include <MsgBoxConstants.au3>
Example()
Func Example()
Local $aItem, $idListView
GUICreate("ListView: Setzt und ermittelt das Item (v" & @AutoItVersion & ")", 500, 300)
$idListView = GUICtrlCreateListView("", 2, 2, 394, 268)
GUISetState(@SW_SHOW)
; Fügt Spalten hinzu
_GUICtrlListView_AddColumn($idListView, "Items", 100)
GUICtrlCreateListViewItem("Zeile 0", $idListView)
GUICtrlCreateListViewItem("Zeile 1", $idListView)
GUICtrlCreateListViewItem("Zeile 2", $idListView)
; Setzt den Text von dem Item 1
$aItem = _GUICtrlListView_GetItem($idListView, 1)
MsgBox($MB_SYSTEMMODAL, "Information", "Item 1 Text: " & $aItem[3])
; Ändert Item 1
MsgBox($MB_SYSTEMMODAL, "Information", "Item 1 wird geändert")
_GUICtrlListView_SetItem($idListView, "Neues Item 1", 1)
; Die Schleife wiederholt sich, bis der Benutzer die Beenden-Aktion der GUI auslöst.
Do
Until GUIGetMsg() = $GUI_EVENT_CLOSE
GUIDelete()
EndFunc ;==>Example