INPUTBOX |
Boite de dialogue d'entrée de données |
|---|---|
| Visual Basic | |
Syntaxe
| Function InputBox(ByVal question As String, Optional ByVal Titre As String="", Optional ByVal DefaultResponse As String="", Optional ByVal Xpos As Integer=-1, Optional ByVal YPos As Integer=-1, Optional ByVal helpfile As String="", Optional ByVal context As Integer="") As String |
Paramètres
| Nom | Description |
|---|---|
| question | Ce paramètre permet d'indiquer la question à afficher. La longueur maximale du prompt est d'environ 1024 caractères, selon la largeur des caractères utilisés. Si le prompt se compose de plusieurs lignes, vous pouvez séparer les lignes en utilisant un caractère de retour chariot (Chr(13)), un caractère de saut de ligne (Chr(10)) ou une combinaison de caractères retour chariot-saut de ligne (Chr(13) & Chr(10)) entre chaque ligne. |
| Titre | Ce paramètre permet d'indiquer la titre de la boite de dialogue. Si vous omettez le titre, le nom de l'application est placé dans le titre. |
| DefaultResponse | Ce paramètre permet d'indiquer la réponse par défaut. Si vous omettez la valeur par défaut, la zone de texte s'affiche vide. |
| Xpos | Ce paramètre permet d'indiquer la position horizontale. Ainsi, il indique la distance horizontale entre le bord gauche de la boîte de dialogue et le bord gauche de l'écran. Si Xpos est omis, la boîte de dialogue est centrée horizontalement. |
| Ypos | Ce paramètre permet d'indiquer la position verticale. Ainsi, si il indique la distance verticale entre le bord supérieur de la boîte de dialogue et le haut de l'écran. Si Ypos est omis, la boîte de dialogue est positionnée verticalement à environ un tiers de la hauteur de l'écran. |
| helpfile | Ce paramètre permet d'indiquer une expression de chaîne de caractères identifiant le fichier d'aide à utiliser pour fournir une aide contextuelle pour la boîte de dialogue. Si un fichier d'aide est fourni, le contexte doit également être fourni. |
| context | Ce paramètre permet d'indiquer une expression numérique identifiant le numéro de contexte d'aide attribué par l'auteur de l'aide à la rubrique d'aide appropriée. Si le contexte est fourni, le fichier d'aide indiqué par le paramètre helpfile doit également être fourni. |
Description
Cette procédure permet d'afficher un boite de dialogue avec une question et un bouton «Ok» et «Annuler».
Remarques
- Lorsque le fichier d'aide et le contexte sont fournis, un bouton Aide est automatiquement ajouté à la boîte de dialogue.
- Si l'utilisateur clique sur OK ou appuie sur Enter, la fonction InputBox renvoie tout ce qui se trouve dans la zone de texte. Si l'utilisateur clique sur Cancel ou Annuler, la fonction renvoie une chaîne de caractères de longueur nulle ("").
- L'exemple suivant utilise la fonction InputBox pour afficher une zone de saisie et affecter la chaîne de caractères à la variable Input :
- La fonction InputBox est une manière simple et rapide d'obtenir une entrée utilisateur sans avoir besoin de créer une interface graphique complexe. Elle est parfaite pour des applications ou scripts demandant une interaction minimale.
- Le paramètre question est essentiel car il définit le message qui s'affichera dans la boîte de dialogue. Ce message doit être clair et concis pour guider correctement l'utilisateur lors de la saisie.
- Le paramètre Titre permet de personnaliser l'apparence de la boîte de dialogue. S'il est laissé vide, le titre par défaut sera celui de l'application, ce qui peut ne pas toujours être représentatif de la demande faite à l'utilisateur.
- Grâce au paramètre DefaultResponse, on peut préremplir la zone de texte avec une valeur par défaut, facilitant la tâche à l'utilisateur, notamment pour des réponses standardisées ou attendues fréquemment.
- Les paramètres Xpos et Ypos permettent de contrôler précisément l'emplacement de la boîte de dialogue sur l'écran. Cela peut être très utile pour créer une interface plus ergonomique ou pour éviter qu'une fenêtre ne se superpose à d'autres éléments critiques.
- La combinaison des paramètres helpfile et context ajoute un niveau supplémentaire d'aide contextuelle. Cela est particulièrement utile dans des applications complexes où l'utilisateur pourrait avoir besoin d'assistance pour répondre correctement.
- La fonction InputBox retourne une chaîne vide ("") si l'utilisateur clique sur Annuler, ce qui permet de gérer facilement l'annulation de l'action sans lever d'erreur. Une vérification simple sur le retour peut adapter le comportement du programme.
Dernière mise à jour : Lundi, le 19 novembre 2012