Méthode IConsole ::MessageBox (mmc.h)
Affiche une boîte de message.
Syntaxe
HRESULT MessageBox(
[in] LPCWSTR lpszText,
[in] LPCWSTR lpszTitle,
[in] UINT fuStyle,
[out] int *piRetval
);
Paramètres
[in] lpszText
Pointeur vers une chaîne terminée par null qui contient le message à afficher.
[in] lpszTitle
Pointeur vers une chaîne terminée par null utilisée pour le titre de la zone de message. Si ce paramètre a la valeur NULL, le titre par défaut « Error » est utilisé.
[in] fuStyle
Valeur qui spécifie un ensemble d’indicateurs de bits qui déterminent le contenu et le comportement de la zone de message. Ce paramètre peut être une combinaison d’indicateurs des groupes d’indicateurs suivants extraits de la documentation de l’API Windows MessageBox.
Spécifiez l’un des indicateurs suivants pour indiquer quels boutons s’affichent dans la boîte de message.
MB_ABORTRETRYIGNORE
La zone de message contient trois boutons : Abandonner, Réessayer et Ignorer.
MB_OK
La boîte de message contient un bouton : OK. Il s’agit de la valeur par défaut.
MB_OKCANCEL
La zone de message contient deux boutons : OK et Annuler.
MB_RETRYCANCEL
La zone de message contient deux boutons : Réessayer et Annuler.
MB_YESNO
La boîte de message contient deux boutons : Oui et Non.
MB_YESNOCANCEL
La zone de message contient trois boutons : Oui, Non et Annuler.
Spécifiez l’un des indicateurs suivants pour indiquer l’icône qui s’affiche dans la boîte de message :
MB_ICONEXCLAMATION, MB_ICONWARNING
Une icône de point d’exclamation s’affiche dans la zone de message.
MB_ICONINFORMATION, MB_ICONASTERISK
Une icône composée d’un « I » dans un cercle s’affiche dans la zone de message.
MB_ICONQUESTION
Une icône de point d’interrogation s’affiche dans la zone de message.
MB_ICONSTOP,
MB_ICONERROR, MB_ICONHAND
Une icône de signe d’arrêt s’affiche dans la boîte de message.
Spécifiez l’un des indicateurs suivants pour indiquer le bouton par défaut :
MB_DEFBUTTON1
Le premier bouton est le bouton par défaut, sauf si l’un des autres indicateurs de ce groupe est spécifié comme valeur par défaut.
MB_DEFBUTTON2
Le deuxième bouton est le bouton par défaut.
MB_DEFBUTTON3
Le troisième bouton est le bouton par défaut.
MB_DEFBUTTON4
Le quatrième bouton est le bouton par défaut.
Spécifiez l’un des indicateurs suivants pour indiquer la modalité de la boîte de dialogue :
MB_APPLMODAL
L’utilisateur doit répondre à la boîte de message avant de poursuivre le travail dans la fenêtre active. Toutefois, l’utilisateur peut se déplacer vers les fenêtres d’autres applications et travailler dans ces fenêtres. La valeur par défaut est MB_APPLMODAL si ni MB_SYSTEMMODAL ni MB_TASKMODAL n’est spécifié.
MB_SYSTEMMODAL
Toutes les applications sont suspendues jusqu’à ce que l’utilisateur réponde à la boîte de message. Les boîtes de message modales système sont utilisées pour informer l’utilisateur des erreurs graves et potentiellement dommageables qui nécessitent une attention immédiate et qui doivent être utilisées avec parcimonie.
MB_TASKMODAL
Similaire à MB_APPLMODAL, mais pas utile dans une application Microsoft Foundation Classes (MFC). Cet indicateur est réservé à une application ou une bibliothèque appelante qui n’a pas de handle de fenêtre disponible.
En outre, vous pouvez spécifier les indicateurs suivants :
MB_DEFAULT_DESKTOP_ONLY
Le bureau qui reçoit actuellement une entrée doit être un bureau par défaut ; sinon, la fonction échoue. Un bureau par défaut est celui sur lequel l’application s’exécute une fois que l’utilisateur s’est connecté.
MB_HELP
Ajoute un bouton Aide à la boîte de message. Le fait de choisir le bouton Aide ou d’appuyer sur F1 génère un événement d’aide.
MB_RIGHT
Le texte est justifié à droite.
MB_RTLREADING
Affiche le message et légende texte à l’aide de l’ordre de lecture de droite à gauche pour les systèmes hébreu et arabe.
MB_SETFOREGROUND
La boîte de message devient la fenêtre de premier plan. En interne, le système d’exploitation appelle la fonction SetForegroundWindow pour la boîte de message.
MB_TOPMOST
La zone de message est créée avec le style de fenêtre WS_EX_TOPMOST .
MB_SERVICE_NOTIFICATION
L’appelant est un service qui avertit l’utilisateur d’un événement. La fonction affiche une boîte de message sur le bureau actif actuel, même si aucun utilisateur n’est connecté à l’ordinateur.
Pour plus d’informations sur l’utilisation de cet indicateur, consultez la fonction MessageBox .
MB_SERVICE_NOTIFICATION_NT3x
Cette valeur correspond à la valeur définie pour MB_SERVICE_NOTIFICATION pour les versions antérieures de Windows.
[out] piRetval
Pointeur vers la valeur de retour.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
Remarques
MessageBox ne doit pas être utilisé pour afficher les erreurs qui se produisent lorsque le composant logiciel enfichable n’a pas le focus. Généralement
MessageBox doit être utilisé uniquement lorsque l’erreur demande l’attention de l’utilisateur et lorsque le volet de résultats contient des informations utiles malgré l’erreur.
Dans la plupart des cas, le contrôle OCX du message MMC est un moyen plus approprié d’afficher les messages d’erreur. Pour plus d’informations, consultez Utilisation du contrôle OCX du message MMC.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | mmc.h |
| DLL | Mmcndmgr.dll |