UDF > GUI > GuiTreeView >


_GUICtrlTreeView_Create

Cr�e un contr�le TreeView pour traiter des donn�es organis�es en arbre

#include <GuiTreeView.au3>
_GUICtrlTreeView_Create ( $hWnd, $iX, $iY [, $iWidth = 150 [, $iHeight = 150 [, $iStyle = 0x00000037 [, $iExStyle = 0x00000000]]]] )

Param�tres

$hWnd Handle de la fen�tre parent ou propri�taire
$iX Position horizontale du contr�le
$iY Position verticale du contr�le
$iWidth [optionnel] Largeur du contr�le
$iHeight [optionnel] Hauteur de contr�le
$iStyle [optionnel] Style du contr�le:
    $TVS_CHECKBOXES - Installe des cases � cocher pour les noeuds. Une case � cocher ne s'affichera que si une image est associ�e au noeud.
        Pour cette option, le contr�le utilise efficacement DrawFrameControl pour cr�er et d�finir une liste d'images d'�tat contenant deux images.
        L'image de l'�tat 1 est la case d�coch�e et l'image de l'�tat 2 est la case coch�e.
        D�finir l'�tat de l'image � z�ro supprime la case � cocher.
        La version 5.80 affiche une case � cocher, m�me si aucune image n'est associ�e au noeud.
    $TVS_DISABLEDRAGDROP - Emp�che le contr�le d'envoyer des messages de notification $TVN_BEGINDRAG
    $TVS_EDITLABELS - Permet � l'utilisateur de modifier les �tiquettes des noeuds
    $TVS_FULLROWSELECT - Permet la s�lection d'une rang�e enti�re.
        La totalit� de la ligne du noeud s�lectionn� est mise en surbrillance et un clic n'importe o� sur la ligne du noeud, provoquera sa s�lection.
        Cette option ne peut pas �tre utilis�e en conjonction avec le style $TVS_HASLINES.
    $TVS_HASBUTTONS - Affiche les boutons plus et moins � c�t� des noeuds parents.
        L'utilisateur clique sur les boutons pour d�velopper ou r�duire la liste des noeuds enfants du noeud parent.
        Pour inclure des boutons associ�s aux noeuds de la racine, vous devez �galement sp�cifier $TVS_LINESATROOT.
    $TVS_HASLINES - Utilise des lignes pour afficher la hi�rarchie des noeuds
    $TVS_INFOTIP- Obtient des informations d'info-bulle en envoyant la notification $TVN_GETINFOTIP
    $TVS_LINESATROOT - Utilise des lignes pour lier les noeuds de la racine du contr�le. Cette valeur est ignor�e si
    $TVS_HASLINES n'est pas aussi sp�cifi�e.
    $TVS_NOHSCROLL - D�sactive le d�filement horizontal dans le contr�le. Le contr�le n'affichera pas les barres de d�filement horizontal.
    $TVS_NONEVENHEIGHT - D�finit la hauteur des noeuds � une hauteur paire avec le message $TVM_SETITEMHEIGHT.
        Par d�faut, la hauteur des noeuds doit avoir une valeur impaire.
    $TVS_NOSCROLL - D�sactive � la fois le d�filement horizontal et vertical dans le contr�le. Le contr�le n'affichera pas les barres de d�filement.
    $TVS_NOTOOLTIPS- D�sactive les info-bulles
    $TVS_RTLREADING - D�finit l'affichage du texte de droite � gauche
    $TVS_SHOWSELALWAYS - Oblige un noeud s�lectionn� � rester s�lectionn� lorsque le contr�le perd le focus
    $TVS_SINGLEEXPAND - Oblige un noeud en cours de s�lection � se d�velopper et un noeud en cours de d�s�lection � se r�duire.
        Si la souris est utilis�e en simple clic pour s�lectionner un noeud et que le noeud est ferm� est ferm�, il sera d�velopp�.
        Si l'utilisateur maintient la touche CTRL enfonc�e tout en s�lectionnant un objet, le noeud en cours de d�s�lection ne sera pas r�duit.
        La version 5.80 oblige le noeud en cours de s�lection � se d�velopper et le noeud en cours de d�s�lection � se r�duire.
        Si l'utilisateur maintient la touche CTRL enfonc�e tout en s�lectionnant un noeud, le noeud en cours de d�s�lection ne sera pas r�duit.
    $TVS_TRACKSELECT - Oblige la mise � jour en temps r�el

Par d�faut: $TVS_HASBUTTONS, $TVS_HASLINES, $TVS_LINESATROOT, $TVS_DISABLEDRAGDROP, $TVS_SHOWSELALWAYS
Forc�s: $WS_CHILD, $WS_VISIBLE
$iExStyle [optionnel] Style de contr�le �tendu

Valeur de retour

Succ�s: Retourne le handle du contr�le.
�chec: Retourne 0.

Remarque

Cette fonction est destin�e aux utilisateurs avertis et � ceux qui d�sirent comprendre le fonctionnement du contr�le.

En relation

_GUICtrlTreeView_Destroy

Exemple

#include <GUIConstantsEx.au3>
#include <GuiTreeView.au3>
#include <WindowsConstants.au3>

Global $g_hTreeView

Example()

Func Example()
    Local $hGUI, $hItem
    Local $iStyle = BitOR($TVS_EDITLABELS, $TVS_HASBUTTONS, $TVS_HASLINES, $TVS_LINESATROOT, $TVS_DISABLEDRAGDROP, $TVS_SHOWSELALWAYS, $TVS_CHECKBOXES)
    $hGUI = GUICreate("(UDF Created) TreeView Create", 400, 300)

    $g_hTreeView = _GUICtrlTreeView_Create($hGUI, 2, 2, 396, 268, $iStyle, $WS_EX_CLIENTEDGE)
    GUISetState(@SW_SHOW)

    GUIRegisterMsg($WM_NOTIFY, "WM_NOTIFY")

    _GUICtrlTreeView_BeginUpdate($g_hTreeView)
    For $x = 1 To Random(2, 10, 1)
        $hItem = _GUICtrlTreeView_Add($g_hTreeView, 0, StringFormat("[%02d] New Item", $x))
        For $y = 1 To Random(2, 10, 1)
            _GUICtrlTreeView_AddChild($g_hTreeView, $hItem, StringFormat("[%02d] New Child", $y))
        Next
    Next
    _GUICtrlTreeView_EndUpdate($g_hTreeView)

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

Func WM_NOTIFY($hWnd, $iMsg, $wParam, $lParam)
    #forceref $hWnd, $iMsg, $wParam
    Local $hWndFrom, $iIDFrom, $iCode, $tNMHDR, $hWndTreeview
    $hWndTreeview = $g_hTreeView
    If Not IsHWnd($g_hTreeView) Then $hWndTreeview = GUICtrlGetHandle($g_hTreeView)

    $tNMHDR = DllStructCreate($tagNMHDR, $lParam)
    $hWndFrom = HWnd(DllStructGetData($tNMHDR, "hWndFrom"))
    $iIDFrom = DllStructGetData($tNMHDR, "IDFrom")
    $iCode = DllStructGetData($tNMHDR, "Code")
    Switch $hWndFrom
        Case $hWndTreeview
            Switch $iCode
                Case $NM_CLICK ; L'utilisateur a cliqu� sur le bouton gauche de la souris dans le contr�le
                    _DebugPrint("$NM_CLICK" & @CRLF & "--> hWndFrom:" & @TAB & $hWndFrom & @CRLF & _
                            "-->IDFrom:" & @TAB & $iIDFrom & @CRLF & _
                            "-->Code:" & @TAB & $iCode)
                    ; Retour 1; non nul pour interdire le traitement par d�faut
                    Return 0 ; z�ro pour permettre le traitement par d�faut
                Case $NM_DBLCLK ; L'utilisateur a double-cliqu� sur le bouton gauche de la souris dans le contr�le
                    _DebugPrint("$NM_DBLCLK" & @CRLF & "--> hWndFrom:" & @TAB & $hWndFrom & @CRLF & _
                            "-->IDFrom:" & @TAB & $iIDFrom & @CRLF & _
                            "-->Code:" & @TAB & $iCode)
                    ; Retour 1; non nul pour interdire le traitement par d�faut
                    Return 0 ; z�ro pour permettre le traitement par d�faut
                Case $NM_RCLICK ; L'utilisateur a cliqu� sur le bouton droit de la souris dans le contr�le
                    _DebugPrint("$NM_RCLICK" & @CRLF & "--> hWndFrom:" & @TAB & $hWndFrom & @CRLF & _
                            "-->IDFrom:" & @TAB & $iIDFrom & @CRLF & _
                            "-->Code:" & @TAB & $iCode)
                    ; Retour 1; non nul pour interdire le traitement par d�faut
                    Return 0 ; z�ro pour permettre le traitement par d�faut
                Case $NM_RDBLCLK ; L'utilisateur a double-cliqu� sur le bouton droit de la souris dans le contr�le
                    _DebugPrint("$NM_RDBLCLK" & @CRLF & "--> hWndFrom:" & @TAB & $hWndFrom & @CRLF & _
                            "-->IDFrom:" & @TAB & $iIDFrom & @CRLF & _
                            "-->Code:" & @TAB & $iCode)
                    ; Retour 1; non nul pour interdire le traitement par d�faut
                    Return 0 ; z�ro pour permettre le traitement par d�faut
                Case $NM_KILLFOCUS ; Le contr�le a perdu le focus d'entr�e
                    _DebugPrint("$NM_KILLFOCUS" & @CRLF & "--> hWndFrom:" & @TAB & $hWndFrom & @CRLF & _
                            "-->IDFrom:" & @TAB & $iIDFrom & @CRLF & _
                            "-->Code:" & @TAB & $iCode)
                    ; Aucune valeur de retour
                Case $NM_RETURN ; Le contr�le a le focus d'entr�e et l'utilisateur a appuy� sur une touche
                    _DebugPrint("$NM_RETURN" & @CRLF & "--> hWndFrom:" & @TAB & $hWndFrom & @CRLF & _
                            "-->IDFrom:" & @TAB & $iIDFrom & @CRLF & _
                            "-->Code:" & @TAB & $iCode)
                    ; Retour 1; non nul pour interdire le traitement par d�faut
                    Return 0 ; z�ro pour permettre le traitement par d�faut
                    ; Case $NM_SETCURSOR; Le contr�le positionne le curseur en r�ponse � un message WM_SETCURSOR
                    ; Local $TINFO = DllStructCreate ($tagNMMOUSE, $lParam)
                    ; $hwndFrom = HWnd (DllStructGetData ($TINFO," hwndFrom"))
                    ; $iIDFrom = DllStructGetData ($TINFO," IDFrom")
                    ; $iCode = DllStructGetData ($TINFO, �Code�)
                    ; _DebugPrint (\"$NM_SETCURSOR" et CRLF &" - > hwndFrom :\" & TAB & $& hwndFrom CRLF & _
                    ; � - > IDFrom :\" & TAB & $& iIDFrom CRLF & _
                    ; � - > Code Promo:" & TAB & $& iCode CRLF & _
                    ; � - > ItemSpec :\" & TAB & DllStructGetData ($TINFO," ItemSpec") et CRLF & _
                    ; � - > ItemData :\" & TAB & DllStructGetData ($TINFO," ItemData") et CRLF & _
                    ;"-> X :\" & TAB DllStructGetData & ($TINFO,"X\") et CRLF & _
                    ; � - > Y :\" & TAB & DllStructGetData ($TINFO,"Y\") et CRLF & _
                    ; � - > HitInfo :\" & TAB & DllStructGetData ($TINFO," HitInfo"))
                    ; Retour 0; pour demander au contr�le de g�rer le curseur
                    ; Retour 1; non nul pour emp�cher le contr�le de g�rer le curseur
                Case $NM_SETFOCUS ; Le contr�le a re�u le focus d'entr�e
                    _DebugPrint("$NM_SETFOCUS" & @CRLF & "--> hWndFrom:" & @TAB & $hWndFrom & @CRLF & _
                            "-->IDFrom:" & @TAB & $iIDFrom & @CRLF & _
                            "-->Code:" & @TAB & $iCode)
                    ; Aucune valeur de retour
                Case $TVN_BEGINDRAGA, $TVN_BEGINDRAGW
                    _DebugPrint("$TVN_BEGINDRAG")
                Case $TVN_BEGINLABELEDITA, $TVN_BEGINLABELEDITW
                    _DebugPrint("$TVN_BEGINLABELEDIT")
                Case $TVN_BEGINRDRAGA, $TVN_BEGINRDRAGW
                    _DebugPrint("$TVN_BEGINRDRAG")
                Case $TVN_DELETEITEMA, $TVN_DELETEITEMW
                    _DebugPrint("$TVN_DELETEITEM")
                Case $TVN_ENDLABELEDITA, $TVN_ENDLABELEDITW
                    _DebugPrint("$TVN_ENDLABELEDIT")
                Case $TVN_GETDISPINFOA, $TVN_GETDISPINFOW
                    _DebugPrint("$TVN_GETDISPINFO")
                Case $TVN_GETINFOTIPA, $TVN_GETINFOTIPW
                    _DebugPrint("$TVN_GETINFOTIP")
                Case $TVN_ITEMEXPANDEDA, $TVN_ITEMEXPANDEDW
                    _DebugPrint("$TVN_ITEMEXPANDED")
                Case $TVN_ITEMEXPANDINGA, $TVN_ITEMEXPANDINGW
                    _DebugPrint("$TVN_ITEMEXPANDING")
                Case $TVN_KEYDOWN
                    _DebugPrint("$TVN_KEYDOWN")
                Case $TVN_SELCHANGEDA, $TVN_SELCHANGEDW
                    _DebugPrint("$TVN_SELCHANGED")
                Case $TVN_SELCHANGINGA, $TVN_SELCHANGINGW
                    _DebugPrint("$TVN_SELCHANGING")
                Case $TVN_SETDISPINFOA, $TVN_SETDISPINFOW
                    _DebugPrint("$TVN_SETDISPINFO")
                Case $TVN_SINGLEEXPAND
                    _DebugPrint("$TVN_SINGLEEXPAND")
            EndSwitch
    EndSwitch
    Return $GUI_RUNDEFMSG
EndFunc   ;==>WM_NOTIFY

Func _DebugPrint($s_Text , $sLine = @ScriptLineNumber)
    ConsoleWrite( _
            "!===========================================================" & @CRLF & _
            "+======================================================" & @CRLF & _
            "-->Line(" & StringFormat("%04d", $sLine) & "):" & @TAB & $s_Text  & @CRLF & _
            "+======================================================" & @CRLF)
EndFunc   ;==>_DebugPrint