Fonction InputBox

  • Article

Affiche une invite dans une boîte de dialogue, attend que l’utilisateur tape du texte ou clique sur un bouton, puis retourne une Chaîne avec le contenu de la zone de texte.

Syntaxe

InputBox(prompt, [ title ], [ default ], [ xpos ], [ ypos ], [ helpfile, context ])

La syntaxe de la fonction InputBox comprend les arguments nommés suivants :

Élément Description
prompt Obligatoire. Expression de chaîne affichée en tant que message dans la boîte de dialogue. La longueur maximale de prompt est d’environ 1 024 caractères, en fonction de la largeur des caractères utilisés. Si prompt est constitué de plus d’une ligne, vous pouvez séparer les lignes en utilisant un caractère retour chariot (Chr(13)), un caractère de saut de ligne (Chr(10)), ou une combinaison de caractères retour chariot et saut de ligne ((Chr(13) & (Chr(10)) entre chaque ligne.
title Facultatif. Expression de chaîne affichée dans la barre de titre de la boîte de dialogue. Si vous omettez title, le nom de l’application est placé dans la barre de titre.
default Facultatif. Expression de chaîne affichée dans la zone de texte comme réponse par défaut en l’absence de toute autre entrée. Si vous omettez default, la zone de texte qui s’affiche est vide.
xpos Facultatif. Expression numérique indiquant, en twips, la distance horizontale qui sépare le bord gauche de l'écran de la bordure gauche de la boîte de dialogue. Si l'argument xpos est omis, la boîte de dialogue est centrée horizontalement.
ypos Facultatif. Expression numérique indiquant, en twips, la distance verticale qui sépare la bordure gauche de la boîte de dialogue du bord supérieur de l’écran. Si ypos est omis, la boîte de dialogue est positionnée verticalement à environ un tiers du bas de l’écran.
helpfile Facultatif. Expression de chaîne indiquant le fichier d’Aide à utiliser pour fournir une aide contextuelle pour la boîte de dialogue. Si helpfile est fourni, context doit également être indiqué.
context Facultatif. Expression numérique indiquant le numéro de contexte d’Aide attribué par l’auteur de l’Aide à la rubrique appropriée. Si context est fourni, helpfile doit également être indiqué.

Remarques

Lorsque helpfile et context sont fournis tous les deux, l’utilisateur peut appuyer sur F1 (Windows) ou AIDE (Macintosh) pour afficher la rubrique d’Aide correspondant à context. Certainesapplications hôtes, par exemple, Microsoft Excel, ajoutent automatiquement un bouton Aide à la boîte de dialogue. Si l’utilisateur choisitOK ou appuie sur ENTRÉE, la fonctionInputBox renvoie tout ce qui est dans la zone de texte. Si l’utilisateur choisit Annuler, la fonction renvoie une chaîne de longueur nulle (« »).

La zone de texte n’accepte que 255 caractères. La chaîne de retour est tronquée à 254 caractères.

La zone de texte n’accepte pas les sauts de ligne, tels que Maj+Entrée. Si l’utilisateur colle du texte avec un saut de ligne dans la zone de texte, le texte est tronqué au saut de ligne.

Remarque

Pour spécifier plus que premier argument nommé, vous devez utiliser InputBox dans une expression. Pour omettre certains arguments de position, vous devez inclure le séparateur de virgule correspondant.

Exemple

Cet exemple montre les différentes façons d’utiliser la fonctionInputBoxpour inviter l’utilisateur à entrer une valeur. Si les positions x et y sont omises, la boîte de dialogue est centrée automatiquement pour les axes respectifs. La variable MyValue contient la valeur entrée par l’utilisateur si l’utilisateur choisit OK ou appuie sur la touche ENTRÉE. Si l’utilisateur choisit Annuler, une chaîne de longueur nulle est renvoyée.

Dim Message, Title, Default, MyValue
Message = "Enter a value between 1 and 3"    ' Set prompt.
Title = "InputBox Demo"    ' Set title.
Default = "1"    ' Set default.
' Display message, title, and default value.
MyValue = InputBox(Message, Title, Default)

' Use Helpfile and context. The Help button is added automatically.
MyValue = InputBox(Message, Title, , , , "DEMO.HLP", 10)

' Display dialog box at position 100, 100.
MyValue = InputBox(Message, Title, Default, 100, 100)

Voir aussi

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.