Functions > GUI > GUICtrlCreate >

GUICtrlCreateInput

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

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

Param�tres

text	Le texte du contr�le.
left	La coordonn�e X du coin sup�rieur gauche du contr�le. Si -1 est utilis� alors X sera automatiquement d�termin�e par GUICoordMode.
top	La coordonn�e Y du coin sup�rieur gauche du contr�le. Si -1 est utilis� alors Y sera automatiquement d�termin�e par GUICoordMode.
width	[optionnel] Largeur du contr�le (par d�faut, la largeur pr�c�demment utilis�e).
height	[optionnel] Hauteur du contr�le (par d�faut, la hauteur pr�c�demment utilis�e).
style	[optionnel] D�finit le style du contr�le. Consultez Annexe des styles des contr�les GUI. Par d�faut (-1) : $ES_LEFT, $ES_AUTOHSCROLL Styles forc�s : $WS_TABSTOP seulement si non $ES_READONLY. $ES_MULTILINE est toujours r�initialis�.
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 d�finir ou changer les informations du contr�le consultez les fonctions GUICtrlUpdate....

Pour d�finir un contr�le Input afin d'entrer un mot de passe (l'entr�e de donn�e est cach�e par des ast�risques) utilisez le style $ES_PASSWORD.

Si vous voulez glisser et d�placer un nom de fichier dans le contr�le, il suffit d'ajouter WS_EX_ACCEPTFILES en style �tendu dans la fonction GUICreate() et d�finir l'�tat avec $GUI_DROPACCEPTED.

Apr�s de multiple gliss�s d�plac�s de fichiers dans ce contr�le, vous pouvez r�cup�rer les noms des fichiers qui sont s�par�s par '|' avec GUICtrlRead().

Pour utiliser les valeurs d�finies ci-dessus vous devez inclure #include <EditConstants.au3> dans votre script.

Redimensionnement par d�faut : $GUI_DOCKHEIGHT.

En relation

GUICoordMode (Option), GUICtrlCreateUpdown, GUICtrlRead, GUICtrlSetLimit, GUICtrlUpdate..., GUIGetMsg

Exemple

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

Example()

Func Example()
    GUICreate(" My GUI input acceptfile", 320, 120, @DesktopWidth / 2 - 160, @DesktopHeight / 2 - 45, -1, $WS_EX_ACCEPTFILES)
    Local $idFile = GUICtrlCreateInput("", 10, 5, 300, 20)
    GUICtrlSetState(-1, $GUI_DROPACCEPTED)
    GUICtrlCreateInput("", 10, 35, 300, 20)  ; n'acceptera pas le drag & drop des fichiers
    Local $idBtn = GUICtrlCreateButton("Ok", 40, 75, 60, 20)

    GUISetState(@SW_SHOW)

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

    MsgBox($MB_SYSTEMMODAL, "drag drop file", GUICtrlRead($idFile))
EndFunc   ;==>Example