Functions > Window > Controls >


ControlTreeView

Envoie une commande � un contr�le TreeView32.

ControlTreeView ( "title", "text", controlID, "command" [, option1] )

Param�tres

title Le titre/hWnd/class de la fen�tre � atteindre. Consultez D�finition sp�ciale de titre.
text Le texte de la fen�tre � atteindre. Consultez D�finition sp�ciale de texte.
controlID Le contr�le avec lequel interagir. Consultez Contr�les.
command La commande � envoyer au contr�le (Voir ci-dessous).
option1 [optionnel] Param�tre additionnel requis par certaines commandes.

Valeur de retour

D�pend de la commande comme le montre le tableau ci-dessous. En cas d'erreur (telle qu'une commande ou fen�tre/contr�le invalide), @error = 1.
Commande, Option1 Op�ration
"Check", "item" Coche un �l�ment (si celui-ci le permet).
"Collapse", "item" Replie un �l�ment pour cacher ses sous-�l�ments.
"Exists", "item" Retourne 1 si un �l�ment existe, sinon 0.
"Expand", "item" D�ploie un �l�ment pour montrer ses sous-�l�ments.
"GetItemCount", "item" Retourne le nombre de sous-�l�ments pour un �l�ment s�lectionn�.
"GetSelected" [, UseIndex] Retourne la r�f�rence de l'�l�ment de la s�lection en cours, par la r�f�rence de son texte (ou par son index si UseIndex est mis � 1).
"GetText", "item" Retourne le texte d'un �l�ment.
"IsChecked" Retourne l'�tat d'un �l�ment. 1:coch�, 0:d�coch�, -1:n'est pas de type CheckBox.
"Select", "item" S�lectionne un �l�ment.
"Uncheck", "item" D�coche un �l�ment (si celui-ci le permet).


Le param�tre "item" est un param�tre cha�ne qui est utilis� pour r�f�rencer un �l�ment sp�cifique du 'treeview' par une combinaison de texte et d'index. Les index sont de base 0. Par exemple:
Heading1
----> H1SubItem1
----> H1SubItem2
----> H1SubItem3
----> ----> H1S1SubItem1
Heading2
Heading3

Chaque "niveau" est s�par� par le caract�re "|". Et chaque index est pr�c�d� du caract�re "#". Exemples:
El�ment R�f�rence d'�l�ment
Heading2 "Heading2" ou "#1"
H1SubItem2 "Heading1|H1SubItem2" ou "#0|#1"
H1S1SubItem1 "Heading1|H1SubItem3|H1S1SubItem1" ou "#0|#2|#0"

Les r�f�rences peuvent aussi �tre mix�es tel que "Heading1|#1".

Remarque

Comme AutoIt est une application 32-bit, quelques commandes ne sont pas disponibles pour r�f�rencer une application 64-bit comme Explorer lors de l'ex�cution sur un Windows 64-bit.

En relation

ControlCommand

Exemple

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

Example()

Func Example()
    Local $hGUI = GUICreate("ControlTreeView Example", 212, 212)
    Local $idTreeView_1 = GUICtrlCreateTreeView(6, 6, 200, 160, BitOR($TVS_HASBUTTONS, $TVS_HASLINES, $TVS_LINESATROOT, $TVS_CHECKBOXES), $WS_EX_CLIENTEDGE)
    Local $hTreeView_1 = ControlGetHandle($hGUI, "", $idTreeView_1)

    Local $idRoot = GUICtrlCreateTreeViewItem("Root", $idTreeView_1)
    GUICtrlCreateTreeViewItem("Item 1", $idRoot)
    GUICtrlCreateTreeViewItem("Item 2", $idRoot)
    GUICtrlCreateTreeViewItem("Item 3", $idRoot)
    Local $idItem_4 = GUICtrlCreateTreeViewItem("Item 4", $idRoot)
    GUICtrlCreateTreeViewItem("Item 4.1", $idItem_4)
    GUICtrlCreateTreeViewItem("Item 4.2", $idItem_4)
    GUICtrlCreateTreeViewItem("Item 5", $idRoot)

    GUISetState(@SW_SHOW, $hGUI)

    ControlTreeView($hGUI, "", $hTreeView_1, "Expand", "Root")

    ControlTreeView($hGUI, "", $hTreeView_1, "Exists", "Root|Item 4")
    ControlTreeView($hGUI, "", $hTreeView_1, "Check", "Root|Item 4")
    ControlTreeView($hGUI, "", $hTreeView_1, "Select", "Root|Item 4")
    ControlTreeView($hGUI, "", $hTreeView_1, "Expand", "Root|Item 4")

    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE

    GUIDelete($hGUI)
EndFunc   ;==>Example