Partager via

Interaction.InputBox, méthode

  • Article

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.

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
Public Shared Function InputBox ( _
    Prompt As String, _
    <OptionalAttribute> Optional Title As String = "", _
    <OptionalAttribute> Optional DefaultResponse As String = "", _
    <OptionalAttribute> Optional XPos As Integer = -1, _
    <OptionalAttribute> Optional YPos As Integer = -1 _
) As String
'Utilisation
Dim Prompt As String
Dim Title As String
Dim DefaultResponse As String
Dim XPos As Integer
Dim YPos As Integer
Dim returnValue As String

returnValue = Interaction.InputBox(Prompt, Title, DefaultResponse, XPos, YPos)

public static string InputBox (
    string Prompt,
    [OptionalAttribute] string Title,
    [OptionalAttribute] string DefaultResponse,
    [OptionalAttribute] int XPos,
    [OptionalAttribute] int YPos
)

public:
static String^ InputBox (
    String^ Prompt, 
    [OptionalAttribute] String^ Title, 
    [OptionalAttribute] String^ DefaultResponse, 
    [OptionalAttribute] int XPos, 
    [OptionalAttribute] int YPos
)

public static String InputBox (
    String Prompt, 
    /** @attribute OptionalAttribute() */ String Title, 
    /** @attribute OptionalAttribute() */ String DefaultResponse, 
    /** @attribute OptionalAttribute() */ int XPos, 
    /** @attribute OptionalAttribute() */ int YPos
)

public static function InputBox (
    Prompt : String, 
    Title : String, 
    DefaultResponse : String, 
    XPos : int, 
    YPos : int
) : String

Paramètres

  • Prompt
    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 l'argument Prompt occupe plus d'une ligne, n'oubliez pas d'insérer un retour chariot (Chr(13)) ou un saut de ligne (Chr(10)) entre les lignes, ou une combinaison de caractères retour chariot-saut de ligne (Chr(13) & Chr(10)).
  • Title
    Facultatif. 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
    Facultatif. 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
    Facultatif. 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
    Facultatif. 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.

Valeur de retour

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.

Notes

Pour plus d'informations, consultez la rubrique Visual Basic InputBox, fonction (Visual Basic).

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

Si vous souhaitez préciser plus d'informations que celles qui sont fournies par le premier argument, vous devez utiliser la fonction InputBox dans une expression. Si vous omettez certains arguments de position, vous devez quand même conserver la virgule de séparation correspondante.

Notes

La fonction InputBox nécessite UIPermission au niveau SafeTopLevelWindows, ce qui peut affecter son exécution dans les situations où le niveau de confiance n'est pas total. Pour plus d'informations, consultez Demande d'autorisations et UIPermission, classe.

Exemple

Cet exemple affiche différentes façons d'utiliser la fonction InputBox pour inviter l'utilisateur à entrer une valeur. Si vous omettez de spécifier les positions de x et de y, les deux axes correspondants sont automatiquement déterminés de manière à centrer la boîte de dialogue. Le MyValue variable 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

Plates-formes

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

Voir aussi

Référence

Interaction, classe
Membres Interaction
Microsoft.VisualBasic, espace de noms

Autres ressources

InputBox, fonction (Visual Basic)
MsgBox, fonction (Visual Basic)
Fonctions Chr, ChrW