Functions > GUI > GUICtrlUpdate >

GUICtrlSetState

Change l'�tat d'un contr�le.

GUICtrlSetState ( controlID, state )

Param�tres

controlID L'ID du contr�le tel que retourn� par une fonction GUICtrlCreate...(), ou -1 pour d�signer le dernier contr�le cr��.
state Consultez le Tableau des Etats ci-dessous.

Valeur de retour

Succ�s: Retourne 1.
�chec: Retourne 0.

Remarques

    Tableau des Etats

Etats Commentaires
$GUI_CHECKED (1) Les contr�les Radio, Checkbox ou ListViewItem seront coch�s.
$GUI_INDETERMINATE (2) Les contr�les Checkbox qui ont l'attribut � trois �tats seront gris�s.
$GUI_UNCHECKED (4) Les contr�les Radio, Checkbox ou ListViewItem seront d�coch�s.
$GUI_DROPACCEPTED (8) Le contr�le acceptera action Drop : � partir d'un fichier ou d'un Drag d'un autre contr�le. Voir Remarques.
$GUI_SHOW (16) Le contr�le sera visible. Le TabItem s�lectionnera le premier onglet � afficher.
$GUI_HIDE (32) Le contr�le ne sera pas visible.
$GUI_ENABLE (64) Le contr�le sera activ�.
$GUI_DISABLE (128) Le contr�le sera gris�.
$GUI_FOCUS (256) Le contr�le recevra le focus pour entr�e/s�lection.
$GUI_DEFBUTTON (512) Le contr�le sera d�fini comme bouton par d�faut de la fen�tre. Voir Remarque sur TreeviewItems.
$GUI_EXPAND (1024) Le contr�le TreeViewItem d�veloppera ses items enfants.
$GUI_ONTOP (2048) Le contr�le aura l'attribut Ontop (au dessus des autres fen�tres) (zOrdering).
$GUI_NODROPACCEPTED (4096) Le contr�le n'acceptera pas l'action Drop.
$GUI_NOFOCUS (8192) Le contr�le ListView perdra le focus.
$GUI_AVISTART (0) Le contr�le Avi d�marrera la vid�o.
$GUI_AVISTOP (1) Le contr�le Avi arr�tera la vid�o.
$GUI_AVICLOSE (2) Le contr�le Avi arr�tera la vid�o et lib�rera les ressources.

Les valeurs d'�tat peuvent s'additionner comme par exemple $GUI_DISABLE(128)+$GUI_HIDE(32) d�finit le contr�le dans un �tat d�sactiv� et cach�.

Si un contr�le AVI doit �tre cach� avec $GUI_HIDE(32), il doit �tre ferm� avec $GUI_AVICLOSE(1).

L'�tat d'un contr�le "contextmenu" ne peut pas �tre chang�.
L'�tat d'un contr�le "ListViewItem" peut �tre modifi� si le contr�le "listview" associ� a �t� cr�� avec un style �tendu $LVS_EX_CHECKBOXES. $GUI_FOCUS(256) et $GUI_NOFOCUS(8192) peuvent �tre utilis�s sur un ListViewItem sp�cifique associ� � un style de contr�le listview qui permet de l'afficher: $LVS_SHOWSELALWAYS.
L'�tat d'un contr�le "menu" ou "menuitem" ne peut pas �tre Hiden (cach�).

! Information importante pour $GUI_EXPAND: cet �tat n'est utilis� que pour TreeViewItems. Si vous souhaitez utiliser cette 'action' alors au moins 1 Sous-TreeViewItem doit exister ou �tre cr�� sous cet item!
Si vous voulez s�lectionner un autre item dans un TreeView, vous pouvez utiliser $GUI_FOCUS(256) - le parent Treeview obtient le focus de la fen�tre et l'item sp�cifi� est marqu� comme s�lectionn�.
Si vous souhaitez d�finir un item de Treeview comme item par d�faut, ce qui signifie la mise en gras, vous pouvez utiliser $GUI_DEFBUTTON(512) - pour annuler la mise en gras il suffit d'utiliser une autre valeur que $GUI_DEFBUTTON(512), par exemple 0. Cet �tat ne sera pas retourn� par GUICtrlGetState().

Si $GUI_DROPACCEPTED(8) est d�fini sur un contr�le visible un drag & drop peut �tre pris en compte. Le contr�le Edit ou Input sera d�fini avec le nom du fichier.
Pour d'autres contr�les � la r�ception de $GUI_EVENT_DROPPED, @GUI_DragId retournera le controlID d'o� le drag a d�marr� (-1 si c'est un fichier, @GUI_DragFile contient le nom du fichier entrain de subir le 'drag') et @GUI_DropId retourne le controlID du contr�le entrain de subir le 'drop'.
C'est seulement lors du 'drag' d'un ListViewItem que d�marrera le processus du drag & drop. @GUI_DragId sera le controlID du ListView.

En relation

GUICtrlCreate..., GUICtrlGetState

Exemple

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

Example()

Func Example()
    ; Cr�e une GUI avec diff�rents contr�les.
    Local $hGUI = GUICreate("Example", 420, 200, -1, -1, -1, $WS_EX_ACCEPTFILES)

    ; Cr�e un contr�le Label et d�finit l'�tat  de 'drop' accept�.
    Local $idLabel = GUICtrlCreateLabel("Drop a file on this label.", 10, 10, 400, 40, $WS_BORDER)
    GUICtrlSetState($idLabel, $GUI_DROPACCEPTED)

    ; Cr�e un contr�le Input et d�finit l'�tat de 'drop' accept�.
    Local $idInput = GUICtrlCreateInput("", 10, 60, 400, 22)
    GUICtrlSetState($idInput, $GUI_DROPACCEPTED)

    Local $idOK = GUICtrlCreateButton("OK", 310, 170, 85, 25)

    ; Affiche la GUI.
    GUISetState(@SW_SHOW, $hGUI)

    Local $idMsg = GUIGetMsg()
    While ($idMsg <> $GUI_EVENT_CLOSE) And ($idMsg <> $idOK)
        If $idMsg = $GUI_EVENT_DROPPED Then
            ; Si la valeur de GUI_DropId est $idLabel, alors d�finit le nom du fichier d�pos�.
            If @GUI_DropId = $idLabel Then GUICtrlSetData($idLabel, @GUI_DragFile)
        EndIf
        $idMsg = GUIGetMsg()
    WEnd

    ; Supprime la GUI pr�c�dente et tous ses contr�les.
    GUIDelete($hGUI)
EndFunc   ;==>Example