InputBox, fonction

Important :  Cet article a été traduit automatiquement, voir l’avertissement. Vous pouvez consulter la version en anglais de cet article ici.

Affiche une invite dans une boîte de dialogue, attend de l’utilisateur entrer du texte ou cliquez sur un bouton et renvoie une chaîne contenant le contenu de la zone de texte.

Syntaxe

InputBox ( invite [titre ] [par défaut ] [, xpos ] [, ypos ] [, fichier d’aide ] [contexte ] )

La syntaxe de la fonction InputBox comprend les arguments suivants :

Argument

Description

invite de commandes

Obligatoire. Expression de chaîne affichée en tant que le 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 invite est constituée de plusieurs lignes, vous pouvez séparer les lignes à l’aide d’un retour chariot (Chr13)()), un caractère de saut de ligne (Chr() 10)) ou retour combinaison chariot (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 le 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 est fournie. Si vous omettez le paramètre 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 l’argument 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 entre le 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 bas 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 l’argument est spécifié, contexte doivent également être fourni.

contexte

Facultatif. Expression numérique qui est le numéro de contexte affecté à la rubrique d’aide appropriée par l’auteur de l’aide. Si le contexte est fourni, fichier d’aide doit également.


Notes

Lorsque le fichier d’aide et contexte sont fournis, l’utilisateur peut appuyer sur F1 (Windows) ou aide (Macintosh) pour afficher la rubrique d’aide correspondant au contexte. Certains application hôte, par exemple, Microsoft Office Excel 2007, ajoutez également automatiquement un bouton aide à la boîte de dialogue. Si l’utilisateur clique sur OK ou appuie sur entrée, la fonction InputBox renvoie se trouvant 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 de position, vous devez inclure la virgule de séparation correspondante.

Exemple

Remarque : Exemples suivants illustrent l’utilisation de cette fonction dans une Visual Basic pour le module d’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 recherche et entrez un ou plusieurs termes dans la zone de recherche.

Cet exemple montre les différentes façons d’utiliser la fonction InputBox pour inviter l’utilisateur à entrer une valeur. Si x et y positions 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 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)

Remarque : Avertissement traduction automatique : cet article a été traduit par un ordinateur, sans intervention humaine. Microsoft propose cette traduction automatique pour offrir aux personnes ne maîtrisant pas l’anglais l’accès au contenu relatif aux produits, services et technologies Microsoft. Comme cet article a été traduit automatiquement, il risque de contenir des erreurs de grammaire, de syntaxe ou de terminologie.

Développez vos compétences
Découvrez des formations
Accédez aux nouvelles fonctionnalités en avant-première
Rejoignez le programme Office Insider

Ces informations vous ont-elles été utiles ?

Nous vous remercions pour vos commentaires.

Merci pour vos commentaires. Il serait vraisemblablement utile pour vous de contacter l’un de nos agents du support Office.

×