Cette fonction peut être utilisée uniquement dans le script et ouvre une zone de message lors de l'exécution de celui-ci. Les paramètres msg et caption sont respectivement utilisés comme textes de message et de légende. Le paramètre mb_buttons définit les boutons qui seront affichés dans la zone de message, en fonction des éléments suivants :
0 ou 'OK' pour un seul bouton OK,
1 ou 'OKCANCEL' pour deux boutons, OK et Cancel,
2 ou 'ABORTRETRYIGNORE' pour trois boutons, Abort, Retry et Ignore,
3 ou 'YESNOCANCEL' pour trois boutons, Yes, No et Cancel,
4 ou 'YESNO' pour deux boutons, Yes et No,
5 ou 'RETRYCANCEL' pour deux boutons, Retry et Cancel.
Le paramètre mb_icons définit l'icône qui sera affichée dans la zone de message, en fonction des éléments suivants :
0 ou chaîne vide pour aucune icône,
16 ou 'ICONHAND' pour une icône avec un X, utilisée pour les erreurs critiques,
32 ou 'ICONQUESTION' pour une icône avec un point d'interrogation,
48 ou 'ICONEXCLAMATION' pour une icône avec un point d'exclamation, utilisée pour les erreurs mineures, les précautions et les avertissements
64 ou 'ICONASTERISK' pour une icône avec un i, utilisée pour les messages d'information.
Le paramètre mb_defbutton définit les boutons qui seront affichés dans la zone de message, en fonction des éléments suivants :
0 or 'DEFBUTTON1' si le premier bouton doit être mis en évidence,
256 ou 'DEFBUTTON2' si le deuxième bouton doit être mis en évidence,
512 ou 'DEFBUTTON3' si le troisième bouton doit être mis en évidence,
768 ou 'DEFBUTTON4' si le quatrième bouton doit être mis en évidence.
Cette fonction renvoie un entier correspondant au bouton actionné par l'utilisateur, en fonction des éléments suivants :
1 pour OK,
2 pour Cancel,
3 pour Abort,
4 pour Retry,
5 pour Ignore,
6 pour Yes,
7 pour No
Les paramètres 3, 4 et 5 seront ajoutés en interne, par conséquent, si vous utilisez des valeurs numériques autres que celles mentionnées ci-dessus, il se peut qu'une combinaison inattendue d'icônes et de boutons soit générée.
La fonction de zone de message renvoie la valeur NULL si la boîte de dialogue ne peut pas être affichée.
Exemple :
Load
MsgBox('Message 2', 'msgbox', 'OKCANCEL', 'ICONASTERISK') as x, 2 as r
autogenerate 1;
MsgBox(str
msg [, str caption [, mb_buttons [, mb_icons[, mb_defbutton]]]] )