MessageBox Classe

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Affiche une boîte de message.

public ref class MessageBox sealed

public sealed class MessageBox

type MessageBox = class

Public NotInheritable Class MessageBox

Héritage

Object

MessageBox

Remarques

Une boîte de message est une boîte de dialogue modale préfabriquée qui affiche un message texte à un utilisateur. Vous affichez une zone de message en appelant la méthode statique Show de la MessageBox classe . Le message texte affiché est l’argument de chaîne que vous passez à Show. Plusieurs surcharges de la Show méthode vous permettent également de fournir une légende de barre de titre.

Pour permettre à un utilisateur de fermer une zone de message, Show affiche une zone de message contenant un bouton OK et un bouton Fermer dans la barre de titre.

Vous pouvez également utiliser une boîte de message pour poser une question à un utilisateur. L’utilisateur répond en cliquant sur l’un des boutons que vous spécifiez à afficher à l’aide de l’énumération MessageBoxButton . Vous pouvez passer cette énumération à plusieurs surcharges de la Show méthode. La valeur par défaut de l’énumération MessageBoxButton est OK.

Vous pouvez déterminer le bouton sur lequel un utilisateur clique en examinant la valeur qui Show retourne. La valeur de retour est une valeur de l’énumération MessageBoxResult , où chaque valeur équivaut à l’un des boutons qu’une boîte de message peut afficher. La valeur par défaut pour la zone de message est OK que OK est le bouton de boîte de message par défaut. Toutefois, certaines surcharges de la Show méthode vous permettent de fournir une valeur par défaut différente MessageBoxResult .

Les boîtes de message peuvent communiquer des informations et poser des questions qui ont différents degrés d’importance. Les zones de message utilisent des icônes pour indiquer l’importance. Par exemple, les icônes peuvent indiquer si le message est informatif, s’il s’agit d’un avertissement ou s’il est important. L’énumération MessageBoxImage encapsule l’ensemble d’icônes de boîte de message possibles. Par défaut, une zone de message n’affiche pas d’icône. Toutefois, vous pouvez passer une valeur à l’une MessageBoxImage des surcharges de méthode afin de Show spécifier que la zone de message inclut une icône.

Les zones de message fournissent parfois des fonctionnalités spéciales, telles que la lecture de droite à gauche. Vous pouvez personnaliser le comportement d’une zone de message à l’aide d’une ou plusieurs MessageBoxOptions valeurs d’énumération qui sont acceptées par certaines surcharges de la Show méthode.

Les zones de message ont toujours une fenêtre propriétaire. Par défaut, le propriétaire d’une boîte de message est la fenêtre qui est actuellement active dans une application au moment de l’ouverture d’une boîte de message. Toutefois, vous pouvez spécifier un autre propriétaire pour le Window en utilisant l’une des Show surcharges suivantes. Pour plus d’informations sur les fenêtres propriétaires, consultez Window.Owner.

Pour plus d’informations, consultez Exemple MessageBox.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Show(String)	Affiche une boîte de message qui contient un message et retourne un résultat.
Show(String, String)	Affiche une boîte de message qui contient un message et une légende de barre de titre et retourne un résultat.
Show(String, String, MessageBoxButton)	Affiche une boîte de message qui contient un message, une légende de barre de titre et un bouton et retourne un résultat.
Show(String, String, MessageBoxButton, MessageBoxImage)	Affiche une boîte de message qui contient un message, une légende de barre de titre, un bouton et une icône et retourne un résultat.
Show(String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult)	Affiche une boîte de message qui contient un message, une légende de barre de titre, un bouton et une icône, accepte un résultat de boîte de message par défaut et retourne un résultat.
Show(String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult, MessageBoxOptions)	Affiche une boîte de message qui contient un message, une légende de barre de titre, un bouton et une icône, accepte un résultat de message par défaut, est conforme aux options spécifiées et retourne un résultat.
Show(Window, String)	Affiche une boîte de message devant la fenêtre spécifiée. La boîte de message affiche un message et retourne un résultat.
Show(Window, String, String)	Affiche une boîte de message devant la fenêtre spécifiée. La boîte de message affiche un message et une légende de barre de titre et retourne également un résultat.
Show(Window, String, String, MessageBoxButton)	Affiche une boîte de message devant la fenêtre spécifiée. La boîte de message affiche un message, une légende de barre de titre et un bouton et retourne également un résultat.
Show(Window, String, String, MessageBoxButton, MessageBoxImage)	Affiche une boîte de message devant la fenêtre spécifiée. La boîte de message affiche un message, une légende de barre de titre, un bouton et une icône et retourne également un résultat.
Show(Window, String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult)	Affiche une boîte de message devant la fenêtre spécifiée. La boîte de message affiche un message, une légende de barre de titre, un bouton et une icône, accepte un résultat de boîte de message par défaut et retourne un résultat.
Show(Window, String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult, MessageBoxOptions)	Affiche une boîte de message devant la fenêtre spécifiée. La boîte de message affiche un message, une légende de barre de titre, un bouton et une icône, accepte un résultat de boîte de message par défaut, est conforme aux options spécifiées et retourne un résultat.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Voir aussi

• MessageBoxButton
• MessageBoxImage
• MessageBoxResult
• MessageBoxOptions