Affiche une invite dans une boîte de dialogue, attend que l’utilisateur entre du texte ou clique sur un bouton, puis retourne une chaîne contenant le contenu de la zone de texte.
Syntaxe
InputBox ( prompt [, title ] [, default ] [, xpos ] [, ypos ] [, helpfile ] [, context ] )
La syntaxe de la fonction InputBox contient les arguments suivants :
|
Argument |
Description |
|
Invite |
Obligatoire. Expression de chaîne affichée en tant que message dans la boîte de dialogue. La longueur maximale de l’invite est d’environ 1 024 caractères, selon la largeur des caractères utilisés. Si l’invite se compose de plusieurs lignes, vous pouvez séparer les lignes à l’aide d’un caractère de retour chariot (Chr(13)), d’un caractère de saut de ligne (Chr(10)) ou d’une combinaison de caractères retour chariot/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 titre, le nom de l’application est placé dans la barre de titre. |
|
par défaut |
Facultatif. Expression 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 omettez la valeur par défaut, la zone de texte s’affiche vide. |
|
xpos |
Facultatif. Expression numérique qui spécifie, en twips, la distance horizontale du bord gauche de la boîte de dialogue par rapport au bord gauche de l’écran. Si xpos est omis, la boîte de dialogue est centrée horizontalement. |
|
ypos |
Facultatif. Expression numérique qui spécifie, en twips, la distance verticale du bord supérieur de la boîte de dialogue à partir du haut de l’écran. Si ypos est omis, la boîte de dialogue est positionnée verticalement environ un tiers du chemin vers le bas de l’écran. |
|
helpfile |
Facultatif. Expression de chaîne qui identifie le fichier d’aide à utiliser pour fournir une aide contextuelle pour la boîte de dialogue. Si helpfile est fourni, le contexte doit également être fourni. |
|
Contexte |
Facultatif. Expression numérique qui est le numéro de contexte d’aide affecté à la rubrique d’aide appropriée par l’auteur de l’aide. Si le contexte est fourni, helpfile doit également être fourni. |
Remarques
Lorsque le fichier d’aide et le contexte sont fournis, l’utilisateur peut appuyer sur F1 (Windows) ou SUR (Macintosh) pour afficher la rubrique d’aide correspondant au contexte. Certains application hôte, par exemple, Microsoft Office Excel 2007, ajoutent également automatiquement un bouton Aide à la boîte de dialogue. Si l’utilisateur clique sur OK ou appuie sur ENTRÉE, la fonction InputBox retourne ce qui se trouve dans la zone de texte. Si l’utilisateur clique sur Annuler, la fonction retourne une chaîne de longueur nulle (« »).
Remarque : Pour spécifier plus que le premier argument nommé, vous devez utiliser InputBox dans un expression. Pour omettre certains arguments positionnels, vous devez inclure le délimiteur de virgule correspondant.
Exemple
Remarque : Les exemples suivants illustrent l’utilisation de cette fonction dans un module Visual Basic pour Applications (VBA). Pour plus d’informations sur l’utilisation de VBA, sélectionnez Référence du développeur dans la liste déroulante en regard de Rechercher et entrez un ou plusieurs termes dans la zone de recherche.
Cet exemple montre différentes façons d’utiliser la fonction InputBox pour inviter l’utilisateur à entrer une valeur. Si les positions x et y sont omises, la boîte de dialogue est automatiquement centrée pour les axes respectifs. La variable MyValue contient la valeur entrée par l’utilisateur si l’utilisateur clique sur OK ou appuie sur la touche Entrée . Si l’utilisateur clique sur Annuler, une chaîne de longueur nulle est retourné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)
