Functions > MessageBoxesDialogs >


InputBox

Affiche une boîte de saisie qui demande à l'utilisateur d'entrer une chaîne.

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

Paramètres

title Le titre de la boîte d'entrée.
prompt Un message à l'utilisateur indiquant quelle sorte d'entrée est attendue.
default [optionnel] La valeur de saisie par défaut que la boîte 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 boîte de saisie.
height [optionnel] La hauteur de la boîte de saisie.
left [optionnel] La coordonnée X du coin supérieur gauche de la boîte de saisie. Par défaut, la boîte est centrée.
top [optionnel] La coordonnée Y du coin supérieur gauche de la boîte de saisie. Par défaut, la boîte 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 boîte InputBox n'a pas réussi à s'ouvrir. Cela est généralement causé par de mauvais arguments.
4 = La boîte 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 boîte 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 boîte 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 boîte 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