Fonction MsgBox de VBScript

Manuel de Référence des Fonctions VBScript

Définition et utilisation

La fonction MsgBox peut afficher une boîte de message, attendre que l'utilisateur clique sur un bouton, puis retourner la valeur indiquant le bouton cliqué.

La fonction MsgBox peut retourner les valeurs suivantes :

  • 1 = vbOK - Le bouton de confirmation est cliqué.
  • 2 = vbCancel - Le bouton d'annulation est cliqué.
  • 3 = vbAbort - Le bouton d'arrêt est cliqué.
  • 4 = vbRetry - Le bouton Réessayer a été cliqué.
  • 5 = vbIgnore - Le bouton Ignorer a été cliqué.
  • 6 = vbYes - Le bouton Oui a été cliqué.
  • 7 = vbNo - Le bouton Non a été cliqué.

Commentaire :Lorsque les paramètres helpfile et context sont spécifiés, l'utilisateur peut appuyer sur la touche F1 pour consulter l'aide.

Avis :Voir la fonction InputBox.

Syntaxe

MsgBox(prompt[,buttons][,title][,helpfile,context])
Paramètres Description
prompt Requis. Expression de chaîne de caractères affichée dans la boîte de dialogue de message. La longueur maximale de prompt est d'environ 1024 caractères, ce qui dépend de la largeur des caractères utilisés. Si prompt contient plusieurs lignes, les lignes peuvent être séparées par un retour chariot (Chr(13)), un saut de ligne (Chr(10)) ou une combinaison de retour chariot et saut de ligne (Chr(13) & Chr(10)).
buttons

Expression numérique, représentant la somme des valeurs numériques pour le nombre et le type de boutons à afficher, le style d'icône utilisé, l'identifiant du bouton par défaut et le style de la boîte de dialogue de message. Si elle est omise, la valeur par défaut de buttons est 0.

La valeur de button :

  • 0 = vbOKOnly - Affiche uniquement le bouton OK.
  • 1 = vbOKCancel - Affiche les boutons OK et Annuler.
  • 2 = vbAbortRetryIgnore - Affiche les boutons Abandonner, Réessayer et Ignorer.
  • 3 = vbYesNoCancel - Affiche les boutons Oui, Non et Annuler.
  • 4 = vbYesNo - Affiche les boutons Oui et Non.
  • 5 = vbRetryCancel - Affiche les boutons Réessayer et Annuler.
  • 16 = vbCritical - Affiche l'icône d'information critique.
  • 32 = vbQuestion - Affiche l'icône de demande d'avertissement.
  • 48 = vbExclamation - Affiche l'icône de message d'avertissement.
  • 64 = vbInformation - Affiche l'icône de message d'information.
  • 0 = vbDefaultButton1 - Le premier bouton est le bouton par défaut.
  • 256 = vbDefaultButton2 - Le deuxième bouton est le bouton par défaut.
  • 512 = vbDefaultButton3 - Le troisième bouton est le bouton par défaut.
  • 768 = vbDefaultButton4 - Le quatrième bouton est le bouton par défaut.
  • 0 = vbApplicationModal - Le mode d'application : l'utilisateur doit répondre aux boîtes de dialogue pour continuer à travailler dans l'application en cours.
  • 4096 = vbSystemModal - Mode système : Toutes les applications sont suspendues avant que l'utilisateur n'ait répondu à la boîte de message.

Le premier ensemble de valeurs (0 - 5) est utilisé pour décrire le type et le nombre de boutons affichés dans la boîte de dialogue ; le second ensemble de valeurs (16, 32, 48, 64) est utilisé pour décrire le style de l'icône ; le troisième ensemble de valeurs (0, 256, 512) détermine le bouton par défaut ; et le quatrième ensemble de valeurs (0, 4096) détermine le style de la boîte de message. Lorsque vous générez la valeur du paramètre buttons en additionnant ces nombres, vous ne pouvez prendre qu'un seul nombre dans chaque ensemble.
title Expression de chaîne affichée dans la barre de titre de la boîte de dialogue. Si le titre est omis, le nom de l'application est affiché dans la barre de titre.
helpfile Expression de chaîne, utilisée pour identifier le fichier d'aide fourni pour le contexte contextuel de la boîte de dialogue. Si le helpfile est fourni, le contexte doit également être fourni. Non disponible sur les plateformes de système 16 bits.
context Expression numérique, utilisée pour identifier le numéro de contexte contextuel attribué par l'auteur de l'aide à un sujet d'aide. Si le contexte est fourni, le helpfile doit également être fourni. Non disponible sur les plateformes de système 16 bits.

Exemple

dim answer
answer=MsgBox("Hello everyone!",65,"Example")
document.write(answer)

Manuel de Référence des Fonctions VBScript