_Application.InputBox(String, Object, Object, Object, Object, Object, Object, Object) Méthode

Définition

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

Object

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.

S’applique à