MSGBOX |
Boite de message |
|---|---|
| Visual Basic | |
Syntaxe
| Function MSGBOX(message As String, [bouton As VbMsgBoxStyle = vbOKOnly], [Titre As String], [HelpFile], [Context]) As VbMsgBoxResult |
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 | Constante | Description | ||
| 0 | vbOKOnly | Cette valeur indique d'afficher seulement le bouton «OK». | ||
| vbDefaultButton1 | Cette valeur indique que le premier bouton est le bouton par défaut. | |||
| 1 | vbOKCancel | Cette valeur indique d'afficher le bouton «OK» et «Annuler» ou «Cancel». | ||
| 2 | vbCancelRetryIgnore | Cette valeur indique d'afficher le bouton «Abandonner» ou «Abort», «Répéter» ou «Retry» et «Ignorer» ou «Ignore». | ||
| 3 | vbYesNoCancel | Cette valeur indique d'afficher le bouton «Oui» ou «Yes», «Non» ou «No» et «Annuler» ou «Cancel». | ||
| 4 | vbYesNo | Cette valeur indique d'afficher le bouton «Oui» ou «Yes» et «Non» ou «No». | ||
| 5 | vbRetryCancel | Cette valeur indique d'affiche le bouton «Répéter» ou «Retry» et «Annuler» ou «Cancel». | ||
| 16 | vbCritical | Cette valeur indique d'afficher l'icône de message critique. | ||
| 32 | vbQuestion | Cette valeur indique d'afficher l'icône de question. | ||
| 48 | vbExclamation | Cette valeur indique d'afficher l'icône de point d'exclamation. | ||
| 64 | vbInformation | Cette valeur indique d'afficher l'icône d'information. | ||
| 256 | vbDefaultButton2 | Cette valeur indique que le deuxième bouton est le bouton par défaut. | ||
| 512 | vbDefaultButton3 | Cette valeur indique que le troisième bouton est le bouton par défaut. | ||
| 768 | vbDefaultButton4 | Cette valeur indique que le quatrième bouton est le bouton par défaut. | ||
| 4096 | vbSystemModal | 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. | |||
| HelpFile | Ce paramètre permet d'indiquer le fichier d'aide. Si le paramètre HelpFile est fourni, le contexte doit également être fourni. Ce paramètre n'est pas disponible sur les plates-formes en 16 bits. | |||
| Context | Ce paramètre permet d'indiquer le contexte. Si le paramètre Context est fourni, le fichier d'aide doit également être fourni. Non disponible sur les plates-formes en 16 bits. | |||
Description
Cette procédure permet d'afficher un boite de dialogue avec un message à l'intérieur.
Remarques
- Voici les valeurs retournés par cette fonction :
- Lorsque les paramètres helpfile et le Context sont fournis, l'utilisateur peut appuyer sur F1 pour afficher la rubrique d'aide correspondant au contexte.
- Si la boîte de dialogue affiche un bouton Annuler, appuyer sur la touche ESC a le même effet que cliquer sur Annuler ou Cancel. Si la boîte de dialogue contient un bouton Aide ou Help, une aide contextuelle est fournie pour la boîte de dialogue. Cependant, aucune valeur n'est renvoyée jusqu'à ce que l'un des autres boutons soit cliqué.
- L'exemple suivant utilise la fonction MsgBox pour afficher une boîte de message et renvoyer une valeur décrivant le bouton sur lequel l'utilisateur a cliqué :
| Valeur | Constante | Description |
|---|---|---|
| 1 | vbOk | Ce code indique un bouton «OK» |
| 2 | vbCancel | Ce code indique un bouton «Annuler» ou «Cancel» |
| 3 | vbAbort | Ce code indique un bouton «Abandonner» ou «Abort». |
| 4 | vbRetry | Ce code indique un bouton «Réessayer» ou «Retry». |
| 5 | vbIgnore | Ce code indique un bouton «Ignorer» ou «Ignore». |
| 6 | vbYes | Ce code indique un bouton «Oui» ou «Yes». |
| 7 | vbNo | Ce code indique un bouton «Non» ou «No» |
Dim MyVar
MyVar = MsgBox ("Bonjour Gladir.com!", 65, "Exemple MsgBox") 'MyVar contient 1 ou 2, selon le bouton sur lequel vous avez cliqué.
Exemple
Voici quelques exemples typiques de l'utilisation de cette fonction :
on obtiendra le résultat suivant :
Bonjour gladir.com
Dernière mise à jour : Lundi, le 19 novembre 2012