MsgBox |
Boite de message |
|---|---|
| VBScript | |
Syntaxe
| Sub MSGBOX(message, bouton, Titre) |
Paramètres
| Nom | Description | ||
|---|---|---|---|
| message | Ce paramètre permet d'indiquer le message à afficher dans la boite de dialogue. La longueur maximale du message est d'environ 1024 caractères, selon la largeur des caractères utilisés. Si le message 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. | ||
| bouton | Ce paramètre permet d'indiquer les boutons et icônes à afficher : | ||
| Valeur | Description | ||
| 0 | Cette valeur indique d'afficher seulement le bouton «OK». | ||
| 1 | Cette valeur indique d'afficher le bouton «OK» et «Annuler» ou «Cancel». | ||
| 2 | Cette valeur indique d'afficher le bouton «Abandonner» ou «Abort», «Répéter» ou «Retry» et «Ignorer» ou «Ignore». | ||
| 3 | Cette valeur indique d'afficher le bouton «Oui» ou «Yes», «Non» ou «No» et «Annuler» ou «Cancel». | ||
| 4 | Cette valeur indique d'afficher le bouton «Oui» ou «Yes» et «Non» ou «No». | ||
| 5 | Cette valeur indique d'affiche le bouton «Répéter» ou «Retry» et «Annuler» ou «Cancel». | ||
| 16 | Cette valeur indique d'afficher l'icône de message critique. | ||
| 32 | Cette valeur indique d'afficher l'icône de question. | ||
| 48 | Cette valeur indique d'afficher l'icône de point d'exclamation. | ||
| 64 | Cette valeur indique d'afficher l'icône d'information. | ||
| 256 | Cette valeur indique que le deuxième bouton est le bouton par défaut. | ||
| 512 | Cette valeur indique que le troisième bouton est le bouton par défaut. | ||
| 768 | Cette valeur indique que le quatrième bouton est le bouton par défaut. | ||
| 4096 | Cette valeur indique qu'il faut obliger l'utilisateur à répondre à cette question. | ||
| Le premier groupe de valeurs (0 à 5) décrit le nombre et le type de boutons affichés dans la boîte de dialogue; le deuxième groupe (16, 32, 48, 64) décrit le style d'icône; le troisième groupe (0, 256, 512, 768) détermine quel bouton est le bouton par défaut; et le quatrième groupe (0, 4096) détermine la modalité de la boîte de message. Lorsque vous ajoutez des nombres pour créer une valeur finale pour les boutons de paramètre, n'utilisez qu'un seul nombre de chaque groupe. | |||
| Titre | Ce paramètre permet d'indiquer le titre de la boite de dialogue. Si vous omettez le titre, le nom de l'application est placé dans la barre de titre. | ||
Description
Cette fonction permet d'afficher un boite de dialogue avec un message à l'intérieur.
Remarques
- La fonction MsgBox est essentielle pour afficher des messages d'information, d'avertissement ou d'erreur à l'utilisateur. Elle permet une interaction minimale mais utile dans les scripts en mode graphique, en présentant des boutons de réponse comme OK, Annuler, Oui ou Non. C'est un moyen pratique de fournir du feedback ou de poser une question simple.
- Le paramètre message peut contenir jusqu'à environ 1024 caractères, en fonction de la taille des caractères utilisés. Pour rendre le message plus lisible, on peut y insérer des sauts de ligne à l'aide des fonctions Chr(13) et Chr(10), ce qui permet d'organiser le contenu sur plusieurs lignes.
- Le paramètre bouton est très flexible : il permet de combiner plusieurs options pour définir les boutons, les icônes, le bouton par défaut et la modalité de la boîte. Toutefois, il est essentiel de choisir une seule valeur par groupe, faute de quoi le comportement de la boîte peut devenir imprévisible.
- Grâce aux icônes personnalisables (valeurs 16, 32, 48, 64), MsgBox peut adapter visuellement son message : un point d'exclamation attire l'attention, une icône de question invite à une décision, et une croix rouge signale une erreur critique. Cela aide à contextualiser le message.
- La boîte peut être modale ou non selon la combinaison choisie, notamment avec la valeur 4096 obligeant l'utilisateur à répondre avant de poursuivre. Cela est très utile pour des messages bloquants, comme lors d'une étape critique d'un traitement.
- Le titre de la boîte, défini par le paramètre Titre, permet de personnaliser l'en-tête de la fenêtre. S'il est omis, c'est le nom de l'application s'affichant, ce qui peut être moins clair pour l'utilisateur. Un bon titre améliore l'identification du contexte de la boîte.
- Il est possible de récupérer le résultat du clic de l'utilisateur (exemple vbYes, vbNo, vbCancel) pour prendre une décision conditionnelle dans le script. Cela transforme MsgBox en un outil non seulement de communication, mais aussi de pilotage logique du déroulement du script.
- Même si MsgBox semble simple, elle est en réalité puissante et personnalisable, notamment grâce à la somme de valeurs dans le paramètre bouton. Par exemple, on peut afficher les boutons Oui/Non avec une icône d'information et définir "Non" comme bouton par défaut, en combinant 4 + 64 + 256.
Dernière mise à jour : Lundi, le 19 Avril 2021