Functions > GUI > GUICtrlCreate >


GUICtrlCreateList

Cr�e un contr�le List pour une GUI.

GUICtrlCreateList ( "text", left, top [, width [, height [, style = -1 [, exStyle = -1]]]] )

Param�tres

text Le texte du contr�le.
left Coordonn�e X du coin sup�rieur gauche du contr�le. Si -1 est utilis� alors X sera d�termin�e en accord avec GUICoordMode.
top Coordonn�e Y du coin sup�rieur gauche du contr�le. Si -1 est utilis� alors Y sera d�termin�e en accord avec GUICoordMode.
width [optionnel] Largeur du contr�le (par d�faut, la largeur utilis�e pr�c�demment).
height [optionnel] Hauteur du contr�le (par d�faut, la hauteur utilis�e pr�c�demment).
style [optionnel] D�finit le style du contr�le. Consultez Annexe des styles des contr�les GUI.
    Par d�faut (-1) : $LBS_SORT, $WS_BORDER, $WS_VSCROLL
    Styles forc�s : $WS_TABSTOP, $LBS_NOTIFY
exStyle [optionnel] D�finit le style �tendu du contr�le. Consultez Table des styles �tendus.
    Par d�faut (-1) : $WS_EX_CLIENTEDGE

Valeur de retour

Succ�s: Retourne l'ID du nouveau contr�le.
�chec: Retourne 0.

Remarques

Pour obtenir la valeur du contr�le, consultez GUICtrlRead.
Pour r�gler ou changer l'information dans le contr�le Consultez GUICtrlUpdate....

Les diff�rentes entr�es de liste qui peuvent �tre s�lectionn�es peuvent �tre r�gl�es avec GUICtrlSetData

Pour limiter l'utilisation de d�filement horizontal GUICtrlSetLimit

Pour combiner les styles avec l'utilisation de style par d�faut BitOR($GUI_SS_DEFAULT_LIST, newstyle,...).
Pour utiliser les valeurs sp�cifi�es ci-dessus, vous devez inclure #include <ListBoxConstants.au3> dans votre script.

Le redimensionnement par d�faut est $GUI_DOCKAUTO la taille et la position seront modifi�es.

En relation

GUICoordMode (Option), GUICtrlSetData, GUICtrlSetLimit, GUICtrlUpdate..., GUIGetMsg

Exemple

#include <GUIConstantsEx.au3>
#include <MsgBoxConstants.au3>

Example()

Func Example()
    Local $sMESSAGE = "Les boutons suivants ont �t� cliqu�s"

    GUICreate("My GUI list") ; Cr�e une GUI centr�e

    Local $idAdd = GUICtrlCreateButton("Ajoute", 64, 32, 75, 25)
    Local $idClear = GUICtrlCreateButton("Efface", 64, 72, 75, 25)
    Local $idMylist = GUICtrlCreateList("Boutons qui ont �t� cliqu�s", 176, 32, 121, 97)
    GUICtrlSetLimit(-1, 200) ; Limite le d�filement horizontal
    GUICtrlSetData(-1, $sMESSAGE)
    Local $idClose = GUICtrlCreateButton("Bouton pour arr�ter", 64, 160, 175, 25)

    GUISetState(@SW_SHOW)

    ; Boucle jusqu'� ce que l'utilisateur quitte.
    Local $idMsg = GUIGetMsg()
    While $idMsg <> $GUI_EVENT_CLOSE And $idMsg <> $idClose 
        Switch $idMsg
            Case $idAdd
                GUICtrlSetData($idMylist, "Vous avez cliqu� sur le bouton N�1!")
            Case $idClear
                GUICtrlSetData($idMylist, "")
        EndSwitch
        $idMsg = GUIGetMsg()
    WEnd

    If $idMsg = $idClose then
        MsgBox($MB_SYSTEMMODAL, "", "Vous avez cliqu� sur le bouton de fermeture", 2)
    EndIf
EndFunc   ;==>Example