Interaction.InputBox(String, String, String, Int32, Int32) Méthode

Définition

Affiche une invite dans une boîte de dialogue, attend que l'utilisateur tape du texte ou clique sur un bouton, puis retourne le contenu de la zone de texte sous la forme d'une chaîne.

public static string InputBox (string Prompt, string Title = "", string DefaultResponse = "", int XPos = -1, int YPos = -1);
static member InputBox : string * string * string * int * int -> string
Public Function InputBox (Prompt As String, Optional Title As String = "", Optional DefaultResponse As String = "", Optional XPos As Integer = -1, Optional YPos As Integer = -1) As String

Paramètres

Prompt
String

L'expression String requise affichée comme message de la boîte de dialogue. La longueur maximale de l'argument Prompt est d'environ 1 024 caractères selon la largeur des caractères utilisés. Si Prompt se compose de plusieurs lignes, vous pouvez séparer les lignes à l’aide d’un caractère retour chariot (Chr(13)), d’un caractère de saut de ligne (Chr(10)) ou d’une combinaison retour chariot/saut de ligne (Chr(13) & Chr(10)) entre chaque ligne.

Title
String

Optionnel. Expression String affichée dans la barre de titre de la boîte de dialogue. Si l'argument Title est omis, le nom de l'application est placé dans la barre de titre.

DefaultResponse
String

Optionnel. Expression String affichée dans la zone de texte comme réponse par défaut si aucune autre entrée n'est fournie. Si l'argument DefaultResponse est omis, la zone de texte affichée est vide.

XPos
Int32

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

YPos
Int32

Optionnel. Expression numérique qui spécifie, en twips, la distance entre le bord supérieur de la boîte de dialogue et le bord haut de l'écran. Si l'argument YPos est omis, la boîte de dialogue est positionnée verticalement, à environ un tiers de l'écran en partant du haut.

Retours

Affiche une invite dans une boîte de dialogue, attend que l'utilisateur tape du texte ou clique sur un bouton, puis retourne le contenu de la zone de texte sous la forme d'une chaîne.

Exemples

Cet exemple montre différentes façons d’utiliser la InputBox fonction 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.

Dim message, title, defaultValue As String
Dim myValue As Object
' Set prompt.
message = "Enter a value between 1 and 3"
' Set title.
title = "InputBox Demo"
defaultValue = "1"   ' Set default value.

' Display message, title, and default value.
myValue = InputBox(message, title, defaultValue)
' If user has clicked Cancel, set myValue to defaultValue
If myValue Is "" Then myValue = defaultValue

' Display dialog box at position 100, 100.
myValue = InputBox(message, title, defaultValue, 100, 100)
' If user has clicked Cancel, set myValue to defaultValue
If myValue Is "" Then myValue = defaultValue

Remarques

Si l’utilisateur clique sur Annuler, une chaîne de longueur nulle est retournée.

Pour spécifier plus que le premier argument, vous devez utiliser la InputBox fonction dans une expression. Si vous omettez des arguments positionnels, vous devez conserver le délimiteur de virgule correspondant.

Notes

La InputBox fonction nécessite UIPermission au SafeTopLevelWindows niveau, ce qui peut affecter son exécution dans des situations de confiance partielle. Pour plus d’informations, consultez Demande d’autorisations et UIPermission .

S’applique à

Voir aussi