Affiche une invite dans une boîte de dialogue, attend que l’utilisateur saisisse du texte ou clique sur un bouton, et renvoie 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 |
|---|---|
| Requête | Obligatoire. Expression de chaîne affichée comme message dans la boîte de dialogue. La longueur maximale de l’invite est d’environ 1 024 caractères, en fonction de la largeur des caractères utilisés. Si l’invite comporte plusieurs lignes, vous pouvez les séparer à 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 de retour chariot et de saut de ligne (Chr(13) & Chr(10)) entre chaque ligne. |
| titre | Facultatif. Expression de chaîne affichée dans la barre de titre de la boîte de dialogue. Si vous omettez de 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 comme 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 à partir du 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 vous ne spécifiez pas ypos , la boîte de dialogue est positionnée verticalement à environ un tiers de l’écran. |
| Fichier d’aide | Facultatif. 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 | Facultatif. Expression numérique qui est le numéro de contexte d’aide attribué à la rubrique d’aide appropriée par l’auteur de l’aide. Si le contexte est fourni, le fichier d’aide doit également être fourni. |
Remarques
Lorsque le fichier d’aide et le contexte sont fournis, l’utilisateur peut appuyer sur F1 (Windows) ou HELP (Macintosh) pour afficher la rubrique d’aide correspondant au contexte. Certaines applications hôtes ajoutent aussi automatiquement un bouton d’aide à la boîte de dialogue. Si l’utilisateur clique sur OK ou appuie sur ENTRÉE , la fonction InputBox renvoie tout ce qui se trouve dans la zone de texte. Si l’utilisateur clique sur Annuler, la fonction renvoie une chaîne nulle (« »).
Remarque
Pour spécifier plus que le premier argument nommé, vous devez utiliser InputBox dans une 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 développeur dans la liste déroulante en regard de Rechercher , puis 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 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)