Aide:GUICtrlCreateInput.txt

Document original V3.3.6.1 :

###Function###
GUICtrlCreateInput

###Description###
Creates an Input control for the GUI.

###Syntax###
GUICtrlCreateInput ( "text", left, top [, width [, height [, style [, exStyle]]]] )


###Parameters###
@@ParamTable@@
text
	The text of the control.
left
	The left side of the control. If -1 is used then left will be computed according to <a href="AutoItSetOption.htm#GUICoordMode">GUICoordMode.
top
	The top of the control. If -1 is used then top will be computed according to <a href="AutoItSetOption.htm#GUICoordMode">GUICoordMode.
width
	[optional] The width of the control (default is the previously used width).
height
	[optional] The height of the control (default is the previously used height).
style
	[optional] Defines the style of the control. See <a href="../appendix/GUIStyles.htm#Edit">GUI Control Styles Appendix</a>.
	
	default ( -1) : $ES_LEFT, $ES_AUTOHSCROLL
	forced styles : $WS_TABSTOP only if no $ES_READONLY. $ES_MULTILINE is always reset.  
exStyle
	[optional] Defines the extended style of the control. See <a href="../appendix/GUIStyles.htm#Extended">Extended Style Table</a>.
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	Returns the identifier (controlID) of the new control.
Failure:	Returns 0.
@@End@@


###Remarks###
To obtain the value of the control see <a href="GUICtrlRead.htm">GUICtrlRead</a>.
To set or change information in the control see <a href="GUICtrlUpdate Management.htm">GUICtrlUpdate...</a>.

For defining an input control for entering passwords (input is hidden with an asterisk) use the $ES_PASSWORD style.

If you want to drag & drop a filename onto this control just add the <a href="../appendix/GUIStyles.htm#Extended">WS_EX_ACCEPTFILES extended style</a> on the <a href="GUICreate.htm">GUICreate()</a> and set the state to $GUI_DROPACCEPTED.
After multiple drag and drop files on this control, you can retrieve the files name which are separated by "|" with GuiCtrlRead.

To use the values specified above you must #include <EditConstants.au3> in your script.

Default resizing is $GUI_DOCKHEIGHT.


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


###Example###
@@IncludeExample@@

Document traduit V3.3.6.1 :

###Function###
GUICtrlCreateInput
 
###Description###
Crée un contrôle Input pour une GUI.
 
###Syntax###
GUICtrlCreateInput ( "text", left, top [, width [, height [, style [, exStyle]]]] )
 
 
###Parameters###
@@ParamTable@@
text
        Le texte du contrôle.
left
        La distance à gauche du contrôle. Si -1 est utilisé alors il sera automatiquement déterminé par <a href="AutoItSetOption.htm#GUICoordMode">GUICoordMode.
top
        La distance en haut du contrôle. Si -1 est utilisé alors il sera automatiquement déterminé par <a href="AutoItSetOption.htm#GUICoordMode">GUICoordMode.
width
        [optionnel] La largeur du contrôle (par défaut c'est la largeur précédemment utilisée).
height
        [optionnel] La hauteur du contrôle (par défaut c'est la hauteur précédemment utilisée).
style
        [optionnel] Définit le style du contrôle . Voir <a href="../appendix/GUIStyles.htm#Edit">GUI Control Styles Appendix</a>.
 
        défaut ( -1) : $ES_LEFT, $ES_AUTOHSCROLL
        Style forcé : $WS_TABSTOP seulement si $ES_READONLY. $ES_MULTILINE ne sont toujours pas rétablis.  
exStyle
        [optionnel] Définit le style étendu du contrôle. voir <a href="../appendix/GUIStyles.htm#Extended">Extended Style Table</a>.
@@End@@

###ReturnValue###
@@ReturnTable@@
Succès:        Retourne l'identifiant (controlID) du nouveau contrôle.
Echec :        Retourne 0.
@@End@@

###Remarks###
Pour obtenir la valeur du contrôle voir <a href="GUICtrlRead.htm">GUICtrlRead</a>.
Pour définir ou changer l'information du contrôle voir <a href="GUICtrlUpdate Management.htm">GUICtrlUpdate...</a>.
 
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 <a href="../appendix/GUIStyles.htm#Extended">WS_EX_ACCEPTFILES en style étendu </a> sur le <a href="GUICreate.htm">GUICreate()</a> 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 au dessus vous devez inclure #include <EditConstants.au3> dans votre script.
 
Redimensionnement par défaut : $GUI_DOCKHEIGHT.

###Related###
GUICoordMode (Option), GUICtrlUpdate..., GUIGetMsg, GUICtrlRead, GUICtrlCreateUpdown, GUICtrlSetLimit
 
 
###Example###
@@IncludeExample@@

Traducteur : ZOTHOP

Contributeurs (pour les modifications avant le Wiki) :