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

Définition

Espace de noms:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

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.

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

Expression requise String affichée en tant que message dans la boîte de dialogue. La longueur maximale est Prompt d’environ 1 024 caractères, selon la largeur des caractères utilisés. Si Prompt elle 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 chariot retour/saut de ligne (Chr(13) & Chr(10)) entre chaque ligne.

Title
String

Optional. String expression 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.

DefaultResponse
String

Optional. String expression affichée dans la zone de texte comme réponse par défaut si aucune autre entrée n’est fournie. Si vous omettez DefaultResponse, la zone de texte affichée est vide.

XPos
Int32

Optional. Expression numérique qui spécifie, en twips, la distance du bord gauche de la boîte de dialogue à partir du bord gauche de l’écran. Si vous omettez XPos, la boîte de dialogue est centrée horizontalement.

YPos
Int32

Optional. Expression numérique qui spécifie, en twips, la distance du bord supérieur de la boîte de dialogue en haut de l’écran. Si vous omettez YPos, la boîte de dialogue est positionnée verticalement à environ un tiers de l’écran.

Retours

String

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.

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.

Note

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