_Application.InputBox Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Cette méthode affiche une boîte de dialogue dans laquelle l'utilisateur peut saisir des données. Elle renvoie les informations saisies dans la boîte de dialogue.
public object InputBox (string Prompt, object Title, object Default, object Left, object Top, object HelpFile, object HelpContextID, object Type);
Public Function InputBox (Prompt As String, Optional Title As Object, Optional Default As Object, Optional Left As Object, Optional Top As Object, Optional HelpFile As Object, Optional HelpContextID As Object, Optional Type As Object) As Object
Paramètres
- Prompt
- String
Objet obligatoire. Message à afficher dans la boîte de dialogue. Il peut s’agir d’une chaîne, d’un nombre, d’une date ou d’une valeur booléenne .
- Title
- Object
Objet facultatif. Titre de la zone d'entrée. Si vous ne spécifiez pas cet argument, le titre par défaut est « Entrée ».
- Default
- Object
Objet facultatif. Spécifie une valeur qui apparaît dans la zone de texte quand la boîte de dialogue s’affiche. Si cet argument est omis, la zone de texte reste vide. Cette valeur peut être un objet Range.
- Left
- Object
Objet facultatif. Spécifie une position x pour la boîte de dialogue par rapport au coin supérieur gauche de l’écran en points.
- Top
- Object
Objet facultatif. Spécifie une position y pour la boîte de dialogue par rapport au coin supérieur gauche de l’écran en points.
- HelpFile
- Object
Objet facultatif. Nom du fichier d’aide pour cette zone d’entrée. Si les HelpFile
arguments et HelpContextID
sont présents, un bouton Aide s’affiche dans la boîte de dialogue.
- HelpContextID
- Object
Objet facultatif. Numéro d’ID de contexte de la rubrique d’aide dans HelpFile
.
- Type
- Object
Objet facultatif. Spécifie le type des données renvoyées. Si vous ne spécifiez pas cet argument, la boîte de dialogue renvoie du texte. Il peut s’agir d’une ou d’une somme des valeurs suivantes. Vous pouvez utiliser la somme des valeurs autorisées pour Type
. Par exemple, pour une zone de saisie qui peut accepter du texte et des nombres, définissez Type
sur 1 + 2.
Retours
Remarques
Utilisez InputBox pour afficher une boîte de dialogue où entrer les informations à utiliser dans une macro. La boîte de dialogue est dotée d’un bouton OK et d’un bouton Annuler. Si vous cliquez sur le bouton OK, la méthode InputBox renvoie la valeur entrée dans la boîte de dialogue. Si vous cliquez sur le bouton Annuler, la méthode InputBox renvoie la valeur False.
Si Type
a la valeur 0, InputBox renvoie la formule sous forme de texte, par exemple, « =2*PI()/360 ». Si la formule contient des références, celles-ci sont renvoyées sous forme de références de style A1. (Utilisez ConvertFormula(Object, XlReferenceStyle, Object, Object, Object) pour convertir entre les styles de référence.)
Si Type
est 8, InputBox renvoie un objet Range .
Si vous utilisez la méthode InputBox pour demander à l’utilisateur une formule, vous devez utiliser la FormulaLocal propriété pour affecter la formule à un objet Range . La formule d’entrée est dans la langue de l’utilisateur.
La méthode InputBox diffère de la fonction InputBox en ce qu’elle permet une validation sélective de l’entrée de l’utilisateur et peut être utilisée avec des objets Microsoft Excel, des valeurs d’erreur et des formules. InputBox sans qualificateur d’objet appelle la fonction InputBox .