UDF > GUI > GuiListView >

_GUICtrlListView_AddItem

Ajoute un nouvel �l�ment � la fin de la liste

#include <GuiListView.au3>
_GUICtrlListView_AddItem ( $hWnd, $sText [, $iImage = -1 [, $iParam = 0]] )

Param�tres

$hWnd ID/handle du contr�le
$sText Texte de l'�l�ment. S'il est d�fini � -1, l'�l�ment est d�fini par l'interm�diaire du message de notification $LVN_GETDISPINFO.
$iImage [optionnel] Index, de base 0, de l'ic�ne de l'�l�ment dans la liste d'images du contr�le
$iParam [optionnel] Donn�es d�finies par l'application

Valeur de retour

Succ�s: Retourne l'index du nouvel �l�ment.
�chec: Retourne -1

Remarques

Vous ne pouvez pas utiliser cette fonction pour ins�rer des sous-�l�ments. Utilisez _GUICtrlListView_AddSubItem() pour ins�rer des sous-�l�ments.

Comme AutoIt utilise le param�tre $iParam pour stocker le controlID des �l�ments ListView cr��s de fa�on native, cette valeur doit �tre suffisamment �lev�e pour les �l�ments cr��s par l'UDF afin d'�viter tout conflit avec des contr�les existants - une valeur de d�part de 1000 est recommand�e.

En relation

_GUICtrlListView_AddSubItem

Exemple

#include <GUIConstantsEx.au3>
#include <GuiImageList.au3>
#include <GuiListView.au3>

Example()

Func Example()
    Local $hImage, $idListview

    ; Cr�e une GUI
    GUICreate("ListView Add Item", 400, 300)
    $idListview = GUICtrlCreateListView("", 2, 2, 394, 268)
    GUISetState(@SW_SHOW)

    ; Charge des images
    $hImage = _GUIImageList_Create()
    _GUIImageList_Add($hImage, _GUICtrlListView_CreateSolidBitMap($idListview, 0xFF0000, 16, 16))
    _GUIImageList_Add($hImage, _GUICtrlListView_CreateSolidBitMap($idListview, 0x00FF00, 16, 16))
    _GUIImageList_Add($hImage, _GUICtrlListView_CreateSolidBitMap($idListview, 0x0000FF, 16, 16))
    _GUICtrlListView_SetImageList($idListview, $hImage, 1)

    ; Ajoute des colonnes
    _GUICtrlListView_InsertColumn($idListview, 0, "Column 1", 100)
    _GUICtrlListView_InsertColumn($idListview, 1, "Column 2", 100)
    _GUICtrlListView_InsertColumn($idListview, 2, "Column 3", 100)

    ; Ajoute des �l�ments
    _GUICtrlListView_AddItem($idListview, "Row 1: Col 1", 0)
    _GUICtrlListView_AddItem($idListview, "Row 2: Col 1", 1)
    _GUICtrlListView_AddItem($idListview, "Row 3: Col 1", 2)

    ; Boucle jusqu'� ce que l'utilisateur quitte.
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE

    GUIDelete()
EndFunc   ;==>Example