MessageBox Classe

Définition

Affiche une boîte de message.

public ref class MessageBox sealed
public sealed class MessageBox
type MessageBox = class
Public NotInheritable Class MessageBox
Héritage
MessageBox

Remarques

Une zone de message est une boîte de dialogue modale préfabricé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 qui a 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 plusieurs 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 quel bouton 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 zone de message peut afficher. La valeur par défaut de la zone de message est OK car OK est le bouton de la zone 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 messages 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 informationnel, est un avertissement ou est important. L’énumération MessageBoxImage encapsule l’ensemble des 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 MessageBoxImage valeur à l’une des surcharges de méthode pour spécifier que la zone de Show message inclut une icône.

Les boîtes de messages 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 acceptées par certaines surcharges de la Show méthode.

Les boîtes de messages ont toujours une fenêtre propriétaire. Par défaut, le propriétaire d’une zone de message est la fenêtre actuellement active dans une application au moment où une zone de message est ouverte. Toutefois, vous pouvez spécifier un autre propriétaire pour l’utilisation Window de l’une des Show surcharges. Pour plus d’informations sur les fenêtres propriétaires, consultez Window.Owner.

Pour plus d’informations, consultez l’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)

S’applique à

Voir aussi