_Application.InputBox(String, Object, Object, Object, Object, Object, Object, Object) 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
Required, objet. Message à afficher dans la boîte de dialogue. Il peut s’agit d’une chaîne, d’un nombre, d’une date ou d’une valeur boolé américaine.
- 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 HelpContextID arguments et les arguments sont présents, un bouton Aide apparaît 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’agit d’une ou d’une somme des valeurs suivantes. Vous pouvez utiliser la somme des valeurs permises pour Type . Par exemple, pour une zone d’entrée qui peut accepter du texte et des nombres, Type définissez-la 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 la valeur est 0, InputBox renvoie la formule sous la forme d’un texte ( par Type 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. (À utiliser ConvertFormula(Object, XlReferenceStyle, Object, Object, Object) pour convertir entre les styles de référence.)
Si Type la plage est 8, InputBox renvoie un objet Range.
Si vous utilisez la méthode InputBox pour demander une formule à l’utilisateur, vous devez utiliser la propriété pour affecter la formule FormulaLocal à 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 la validation sélective de l’entrée de l’utilisateur et elle 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.