MessageBox Clase

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationFramework.dll

Muestra un cuadro de mensaje.

public ref class MessageBox sealed

public sealed class MessageBox

type MessageBox = class

Public NotInheritable Class MessageBox

Herencia

Object

MessageBox

Comentarios

Un cuadro de mensaje es un cuadro de diálogo modal prefabricado que muestra un mensaje de texto a un usuario. Para mostrar un cuadro de mensaje, llame al método estático Show de la MessageBox clase . El mensaje de texto que se muestra es el argumento de cadena que se pasa a Show. Varias sobrecargas del Show método también le permiten proporcionar un título de barra de título.

Para permitir que un usuario cierre un cuadro de mensaje, Show muestra un cuadro de mensaje que tiene un botón Aceptar y un botón Cerrar en la barra de título.

También puede usar un cuadro de mensaje para hacer una pregunta a un usuario. El usuario responde haciendo clic en uno de los varios botones que especifique para mostrar mediante la MessageBoxButton enumeración . Puede pasar esta enumeración a varias sobrecargas del Show método . El valor predeterminado de la MessageBoxButton enumeración es OK.

Puede determinar qué botón hace clic un usuario examinando el valor que Show devuelve. El valor devuelto es un valor de la MessageBoxResult enumeración, donde cada valor equivale a uno de los botones que puede mostrar un cuadro de mensaje. El valor predeterminado para el cuadro de mensaje es OK porque Ok es el botón predeterminado del cuadro de mensaje. Sin embargo, algunas sobrecargas del Show método permiten proporcionar un valor predeterminado diferente MessageBoxResult .

Los cuadros de mensaje pueden comunicar información y pueden formular preguntas que tienen distintos grados de importancia. Los cuadros de mensaje usan iconos para indicar importancia. Por ejemplo, los iconos pueden indicar si el mensaje es informativo, es una advertencia o es importante. La MessageBoxImage enumeración encapsula el conjunto de posibles iconos de cuadro de mensaje. De forma predeterminada, un cuadro de mensaje no muestra un icono. Sin embargo, puede pasar un MessageBoxImage valor a una de varias Show sobrecargas de método para especificar que el cuadro de mensaje incluya un icono.

Los cuadros de mensaje a veces proporcionan una funcionalidad especial, como la lectura de derecha a izquierda. Puede personalizar el comportamiento de un cuadro de mensaje mediante uno o varios MessageBoxOptions valores de enumeración aceptados por algunas sobrecargas del Show método .

Los cuadros de mensaje siempre tienen una ventana de propietario. De forma predeterminada, el propietario de un cuadro de mensaje es la ventana que está activa actualmente en una aplicación en el momento en que se abre un cuadro de mensaje. Sin embargo, puede especificar otro propietario para Window mediante una de varias Show sobrecargas. Para obtener más información sobre las ventanas de propietario, vea Window.Owner.

Para obtener más información, vea MessageBox Sample.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Show(String)	Muestra un cuadro de mensaje que presenta un mensaje y que devuelve un resultado.
Show(String, String)	Muestra un cuadro de mensaje que presenta un mensaje y un título de la barra de título; y que devuelve un resultado.
Show(String, String, MessageBoxButton)	Muestra un cuadro de mensaje que presenta un mensaje, un título de la barra de título y un botón; y que devuelve un resultado.
Show(String, String, MessageBoxButton, MessageBoxImage)	Muestra un cuadro de mensaje que presenta un mensaje, un título de la barra de título, un botón y un icono; y que devuelve un resultado.
Show(String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult)	Muestra un cuadro de mensaje que presenta un mensaje, un título de la barra de título, un botón y un icono; y que acepta un resultado predeterminado del cuadro de mensaje y devuelve un resultado.
Show(String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult, MessageBoxOptions)	Muestra un cuadro de mensaje que presenta un mensaje, un título de la barra de título, un botón y un icono; y que acepta un resultado predeterminado del cuadro de mensaje, cumple con las opciones especificadas y devuelve un resultado.
Show(Window, String)	Muestra un cuadro de mensaje frente a la ventana especificada. El cuadro de mensaje muestra un mensaje y devuelve un resultado.
Show(Window, String, String)	Muestra un cuadro de mensaje frente a la ventana especificada. El cuadro de mensaje muestra un mensaje y un título de la barra de título; y devuelve un resultado.
Show(Window, String, String, MessageBoxButton)	Muestra un cuadro de mensaje frente a la ventana especificada. El cuadro de mensaje muestra un mensaje, un título de la barra de título y un botón; y devuelve igualmente un resultado.
Show(Window, String, String, MessageBoxButton, MessageBoxImage)	Muestra un cuadro de mensaje frente a la ventana especificada. El cuadro de mensaje muestra un mensaje, un título de la barra de título, un botón y un icono; y devuelve igualmente un resultado.
Show(Window, String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult)	Muestra un cuadro de mensaje frente a la ventana especificada. El cuadro de mensaje muestra un mensaje, un título de la barra de título, un botón y un icono; y acepta un resultado predeterminado del cuadro de mensaje y devuelve un resultado.
Show(Window, String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult, MessageBoxOptions)	Muestra un cuadro de mensaje frente a la ventana especificada. El cuadro de mensaje muestra un mensaje, un título de la barra de título, un botón y un icono; y acepta un resultado predeterminado del cuadro de mensaje, cumple con las opciones especificadas y devuelve un resultado.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• MessageBoxButton
• MessageBoxImage
• MessageBoxResult
• MessageBoxOptions