Functions > MessageBoxesDialogs >

InputBox

Affiche une zone de saisie pour entrer du texte.

InputBox ( "title", "prompt" [, "default" [, "password char" [, width = -1 [, height = -1 [, left = Default [, top = Default [, timeout = 0 [, hwnd]]]]]]]] )

Param�tres

title	Le titre de la zone de saisie.
prompt	Un message � l'utilisateur indiquant quelle sorte d'entr�e est attendue.
default	[optionnel] La valeur de saisie par d�faut que la zone doit afficher.
password char	[optionnel] Le caract�re qui va remplacer tous les caract�res tap�s � l'�cran. Si vous voulez que les caract�res tap�s apparaissent, d�finissez le param�tre avec une cha�ne vide ("") (par d�faut) ou un espace pour le premier caract�re. Si vous fournissez une cha�ne multi-caract�res, seul le premier caract�re sera utilis� comme caract�re de masquage. Il y a une signification particuli�re pour le deuxi�me caract�re et les suivants. Voir Remarques.
width	[optionnel] La largeur de la zone de saisie.
height	[optionnel] La hauteur de la zone de saisie.
left	[optionnel] La coordonn�e X du coin sup�rieur gauche de la zone de saisie. Par d�faut, la zone est centr�e.
top	[optionnel] La coordonn�e Y du coin sup�rieur gauche de la zone de saisie. Par d�faut, la zone est centr�e.
timeout	[optionnel] Nombre de secondes d'attente avant d'annuler automatiquement le dialogue InputBox() .
hwnd	[optionnel] Le handle de la fen�tre � utiliser comme parent pour ce dialogue. Par d�faut, la fen�tre du bureau.

Valeur de retour

Succ�s:	Retourne la cha�ne entr�e.
�chec:	Retourne "" (cha�ne vide) et d�finit @error <> 0.
@error:	1 = Le bouton Annuler a �t� cliqu�. 2 = Le d�lai d'attente TimeOut a �t� atteint. 3 = La zone InputBox n'a pas r�ussi � s'ouvrir. Cela est g�n�ralement caus� par de mauvais arguments. 4 = La zone InputBox ne peut pas �tre affich�e sur n'importe quel moniteur. 5 = Param�tres invalides Width sans Height ou Left sans Top.

Remarques

La zone InputBox() est redimensionnable par l'utilisateur, mais a une taille minimum d'environ 190 x 115 pixels. La taille par d�faut est d'environ 250 x 190 pixels.

La cha�ne retourn�e ne doit pas d�passer 254 caract�res et si l'entr�e contient des retours chariot ou saut de ligne, le r�sultat sera tronqu� � la premi�re occurrence de ces caract�res.

Le deuxi�me caract�re et les suivants du champ 'password' peuvent �tre utilis�s pour restreindre l'entr�e. Utilisez un espace comme premier caract�re pour voir tous les caract�res tap�s. Mettez M apr�s le premier caract�re pour indiquer que l'entr�e est Mandatory; c'est-�-dire que vous devez entrer quelque chose. Rien ne se passera ... si vous appuyez sur le bouton Ok quand il n'y a rien dans la zone InputBox(). Elle ne sera pas ferm�e et ne retournera pas de cha�ne.

Si votre script utilise une inputbox vous devez inclure une directive pragma sous la forme "#pragma compile(inputboxres, true)"

Vous pouvez �galement sp�cifier la longueur maximale de l'entr�e � la fin du champ password. Il suffit d'entrer un nombre � la fin du champ.

En relation

MsgBox

Exemple

#include <MsgBoxConstants.au3>

Example()

Func Example()
    ; Place la zone d'entr�e dans le coin en haut � gauche en affichant les caract�res comme ils
    ; sont tap�s.
    Local $sAnswer = InputBox("Question", "O� �tes-vous n�?", "Plan�te Terre", "", _
             -1, -1, 0, 0) ; Affiche le r�sultat. MsgBox($MB_SYSTEMMODAL, "", $sAnswer) ; Demande � l'utilisateur d'entrer un mot de passe. Ne pas oublier de le valider! Local $sPasswd = InputBox("S�curit�", "Entrez votre mot de passe.", "", "*") ; Affiche le r�sultat. MsgBox($MB_SYSTEMMODAL, "", $sPasswd) ; Demande � l'utilisateur d'entrer une r�ponse de 1 ou 2 caract�res. Le M dans le champ du mot de passe ; indique que la cha�ne vide n'est pas accept�e et le 2 indique que la ; r�ponse aura au plus 2 caract�res. Local $sValue = InputBox("Test", "Entrez 1 ou 2 caract�res.", "", " M2") ; Affiche le r�sultat. MsgBox($MB_SYSTEMMODAL, "", $sValue) EndFunc ;==>Example