Boîte de saisie

Affiche une invite dans une boîte de dialogue, attend que l'utilisateur saisisse du texte ou clique sur un bouton, puis renvoie le contenu de la zone de texte.

Structure

InputBox(message[, titre][, valeur par défaut][, position_x][, position_y][, fichier_d'aide, contexte])

Paramètres

message - Chaîne de caractères affichée comme message dans la boîte de dialogue. La longueur maximale de la ligne de commande est d'environ 1 024 caractères, en fonction de la largeur des caractères utilisés. Si l'invite de commande comporte plusieurs lignes, vous pouvez séparer ces lignes en insérant un caractère de retour chariot (Chr(13)), un caractère de saut de ligne (Chr(10)) ou une combinaison des deux (Chr(13) & Chr(10)) entre chaque ligne.

titre - Chaîne de caractères affichée dans la barre de titre de la boîte de dialogue. Si vous n'indiquez pas de titre, le nom de l'application s'affiche dans la barre de titre.

par défaut - Expression sous forme de chaîne affichée dans la zone de texte en tant que réponse par défaut si aucune autre entrée n'est fournie. Si vous n'indiquez pas de valeur par défaut, la zone de texte s'affiche vide.

xpos - Expression numérique qui spécifie, en twips, la distance horizontale entre le bord gauche de la boîte de dialogue et le bord gauche de l'écran. Si xpos est omis, la boîte de dialogue est centrée horizontalement.

ypos - Expression numérique qui spécifie, en twips, la distance verticale entre le bord supérieur de la boîte de dialogue et le haut de l'écran. Si le paramètre ypos est omis, la boîte de dialogue s'affiche à environ un tiers de la hauteur de l'écran.

helpfile - Expression de chaîne qui identifie le fichier d'aide à utiliser pour fournir une aide contextuelle pour la boîte de dialogue. Si le fichier d'aide est fourni, le contexte doit également être fourni.

contexte - Expression numérique qui identifie le numéro de contexte de l'aide attribué par l'auteur de l'aide à la rubrique correspondante. Si le contexte est fourni, le fichier d'aide doit également être fourni.

Description

Lorsque les paramètres « helpfile » et « context » sont tous deux fournis, un bouton « Aide » est automatiquement ajouté à la boîte de dialogue.

Si l'utilisateur clique sur OK ou appuie sur la touche Entrée, la fonction InputBox renvoie le contenu de la zone de texte. Si l'utilisateur clique sur « Annuler », la fonction renvoie une chaîne de caractères de longueur nulle ('').

Exemple

L'exemple suivant utilise la fonction InputBox pour afficher une boîte de dialogue de saisie et attribuer la chaîne de caractères à la variable Input :

Dim Input

Input = InputBox("Entrez votre nom")

MsgBox ("Vous avez saisi : " & Input) |