MsgBox

Affiche un message dans une boîte de dialogue, attend que l'utilisateur clique sur un bouton, puis renvoie une valeur indiquant sur quel bouton l'utilisateur a cliqué.

Structure

MsgBox(message[, boutons][, titre][, fichier_d'aide, contexte])

Paramètres

message - Chaîne de caractères affichée comme message dans la boîte de dialogue. La longueur maximale de la ligne de commande est d'environ 1 024 caractères, en fonction de la largeur des caractères utilisés. Si l'invite de commande comporte plusieurs lignes, vous pouvez séparer ces lignes en insérant un caractère de retour chariot (Chr(13)), un caractère de saut de ligne (Chr(10)) ou une combinaison des deux (Chr(13) & Chr(10)) entre chaque ligne.

boutons - Expression numérique correspondant à la somme des valeurs qui déterminent le nombre et le type de boutons à afficher, le style d'icône à utiliser, l'identification du bouton par défaut et le mode d'affichage de la boîte de dialogue. Consultez la section « Paramètres » pour connaître les valeurs. Si cette valeur n'est pas indiquée, la valeur par défaut pour les boutons est 0.

titre - Chaîne de caractères affichée dans la barre de titre de la boîte de dialogue. Si vous n'indiquez pas de titre, le nom de l'application s'affiche dans la barre de titre.

helpfile - Expression de chaîne qui identifie le fichier d'aide à utiliser pour fournir une aide contextuelle pour la boîte de dialogue. Si le fichier d'aide est fourni, le contexte doit également être fourni. Non disponible sur les plateformes 16 bits.

contexte - Expression numérique qui identifie le numéro de contexte de l'aide attribué par l'auteur de l'aide à la rubrique correspondante. Si le contexte est fourni, le fichier d'aide doit également être fourni. Non disponible sur les plateformes 16 bits.

Valeurs des paramètres

Les paramètres de l'argument « buttons » sont les suivants :

Valeur constante Description

vbOKOnly 0 Afficher uniquement le bouton OK.

vbOKCancel 1 Afficher les boutons OK et Annuler.

vbAbortRetryIgnore 2 Afficher les boutons « Abandonner », « Réessayer » et « Ignorer ».

vbYesNoCancel 3 Afficher les boutons « Oui », « Non » et « Annuler ».

vbYesNo 4 Afficher les boutons « Oui » et « Non ».

vbRetryCancel 5 Afficher les boutons « Réessayer » et « Annuler ».

vbCritical 16 Afficher l'icône de message critique.

vbQuestion 32 Afficher l'icône de requête d'avertissement.

vbExclamation 48 Afficher l'icône de message d'avertissement.

vbInformation 64 Afficher l'icône du message d'information.

vbDefaultButton1 0 Le premier bouton est le bouton par défaut.

vbDefaultButton2 256 Le deuxième bouton est le bouton par défaut.

vbDefaultButton3 512 Le troisième bouton est le bouton par défaut.

vbDefaultButton4 768 Le quatrième bouton est le bouton par défaut.

vbApplicationModal 0 Fenêtre modale de l'application ; l'utilisateur doit répondre à la boîte de dialogue avant de pouvoir poursuivre son travail dans l'application en cours.

vbSystemModal 4096 : boîte de dialogue système ; toutes les applications sont suspendues jusqu'à ce que l'utilisateur réponde à la boîte de message.

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 des icônes ; 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 additionnez des nombres pour obtenir la valeur finale des boutons d'argument, n'utilisez qu'un seul nombre par groupe.

Valeur de retour

La fonction MsgBox renvoie les valeurs suivantes :

Bouton à valeur fixe

vbOK 1 OK

vbCancel 2 Annuler

vbAbort 3 Annuler

vbRetry 4 Réessayer

vbIgnore 5 Ignorer

vbOui 6 Oui

n° 7 n°

Description

Lorsque le fichier d'aide et le contexte sont tous deux fournis, l'utilisateur peut appuyer sur la touche F1 pour afficher la rubrique d'aide correspondant au contexte.

Si la boîte de dialogue comporte un bouton « Annuler », appuyer sur la touche Échap revient à cliquer sur ce bouton. Si la boîte de dialogue comporte un bouton Aide, une aide contextuelle est disponible pour cette boîte de dialogue. Cependant, aucune valeur n'est renvoyée tant qu'on n'a pas cliqué sur l'un des autres boutons.

Lorsque la fonction MsgBox est utilisée avec Microsoft Internet Explorer, le titre de toute boîte de dialogue affichée contient toujours « VBScript: » afin de la distinguer des boîtes de dialogue standard du système.

Exemple

L'exemple suivant utilise la fonction MsgBox pour afficher une boîte de dialogue et renvoyer une valeur indiquant quel bouton a été cliqué :

Dim MyVar

MyVar = MsgBox("Bonjour tout le monde!", 65, "Exemple de MsgBox") ' MyVar contient soit 1, soit 2, selon le bouton sur lequel on a cliqué. |