Compartir vía


MessageBox.Show Método

Definición

Muestra un cuadro de mensaje.

Sobrecargas

Show(String)

Muestra un cuadro de mensaje con el texto especificado.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Muestra un cuadro de mensaje con el texto, el título, los botones, el icono, el botón predeterminado, las opciones y el botón Ayuda especificados, que usa el archivo de Ayuda y la palabra clave de la Ayuda indicados.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Muestra un cuadro de mensaje con el texto, el título, los botones, el icono, el botón predeterminado, las opciones y el botón Ayuda especificados, que usa el archivo de Ayuda, el objeto HelpNavigator y el tema de la Ayuda indicados.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Muestra un cuadro de mensaje con el texto, el título, los botones, el icono, el botón predeterminado, las opciones y el botón Ayuda especificados, que usa el archivo de Ayuda indicado.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

Muestra un cuadro de mensaje con el texto, el título, los botones, el icono, el botón predeterminado, las opciones y el botón Ayuda especificados, que usa el archivo de Ayuda y el objeto HelpNavigator indicados.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Muestra un cuadro de mensaje con el texto, el título, los botones, el icono, el botón predeterminado, las opciones y el botón Ayuda especificados, que usa el archivo de Ayuda y la palabra clave de la Ayuda indicados.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Muestra un cuadro de mensaje delante del objeto especificado y con el texto, título, botones, icono, botón predeterminado y opciones especificados.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Muestra un cuadro de mensaje con el texto, el título, los botones, el icono, el botón predeterminado, las opciones y el botón Ayuda especificados, que usa el archivo de Ayuda indicado.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)

Muestra un cuadro de mensaje con el texto, el título, los botones, el icono, el botón predeterminado, las opciones y el botón Ayuda especificados.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

Muestra un cuadro de mensaje con el texto, el título, los botones, el icono, el botón predeterminado, las opciones y el botón Ayuda especificados, que usa el archivo de Ayuda y el objeto HelpNavigator indicados.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

Muestra un cuadro de mensaje delante del objeto especificado y con el texto, título, botones, icono y botón predeterminado especificados.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)

Muestra un cuadro de mensaje delante del objeto especificado y con el texto, título, botones e icono especificados.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

Muestra un cuadro de mensaje con el texto, el título, los botones, el icono y el botón predeterminado especificados.

Show(IWin32Window, String, String, MessageBoxButtons)

Muestra un cuadro de mensaje delante del objeto especificado y con el texto, título y botones especificados.

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Muestra un cuadro de mensaje con el texto, el título, los botones y el icono especificados.

Show(IWin32Window, String, String)

Muestra un cuadro de mensaje delante del objeto especificado y con el texto y título especificados.

Show(String, String, MessageBoxButtons)

Muestra un cuadro de mensaje con el texto, el título y los botones especificados.

Show(IWin32Window, String)

Muestra un cuadro de mensaje delante del objeto especificado y con el texto especificado.

Show(String, String)

Muestra un cuadro de mensaje con el texto y el título especificados.

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Muestra un cuadro de mensaje con el texto, el título, los botones, el icono, el botón predeterminado y las opciones especificados.

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Muestra un cuadro de mensaje con el texto, el título, los botones, el icono, el botón predeterminado, las opciones y el botón Ayuda especificados, que usa el archivo de Ayuda, el objeto HelpNavigator y el tema de la Ayuda indicados.

Show(String)

Muestra un cuadro de mensaje con el texto especificado.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text);
public static System.Windows.Forms.DialogResult Show (string text);
public static System.Windows.Forms.DialogResult Show (string? text);
static member Show : string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String) As DialogResult

Parámetros

text
String

Texto que se va a mostrar en el cuadro de mensaje.

Devoluciones

Uno de los valores de DialogResult.

Ejemplos

En el ejemplo de código siguiente se muestra un cuadro de mensaje simple.

private void DisplayMessageBoxText()
{
         MessageBox.Show("Hello, world.");
}
Private Sub DisplayMessageBoxText()

    MessageBox.Show("Hello, world.")
End Sub

Comentarios

De forma predeterminada, el cuadro de mensaje muestra un botón Aceptar . El cuadro de mensaje no contiene un subtítulo en el título.

Se aplica a

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Muestra un cuadro de mensaje con el texto, el título, los botones, el icono, el botón predeterminado, las opciones y el botón Ayuda especificados, que usa el archivo de Ayuda y la palabra clave de la Ayuda indicados.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::String ^ keyword);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, keyword As String) As DialogResult

Parámetros

owner
IWin32Window

Implementación del IWin32Window que será propietario del cuadro de diálogo modal.

text
String

Texto que se va a mostrar en el cuadro de mensaje.

caption
String

Texto que se va a mostrar en la barra de título del cuadro de mensaje.

buttons
MessageBoxButtons

Uno de los valores MessageBoxButtons que especifica qué botones se mostrarán en el cuadro de mensaje.

icon
MessageBoxIcon

Uno de los valores de MessageBoxIcon que especifica qué icono se mostrará en el cuadro de mensaje.

defaultButton
MessageBoxDefaultButton

Uno de los valores de MessageBoxDefaultButton que especifica cuál es el botón predeterminado del cuadro de mensaje.

options
MessageBoxOptions

Uno de los valores de MessageBoxOptions que especifica las opciones de pantalla y asociación que se usará para el cuadro de mensaje. Puede transferir 0 si desea usar los valores predeterminados.

helpFilePath
String

Ruta de acceso y nombre del archivo de Ayuda que se va a mostrar cuando el usuario haga clic en el botón Ayuda.

keyword
String

Palabra clave de la Ayuda que se va a mostrar cuando el usuario haga clic en botón Ayuda.

Devoluciones

Uno de los valores de DialogResult.

Excepciones

buttons no es un miembro de MessageBoxButtons.

o bien

icon no es un miembro de MessageBoxIcon.

o bien

El parámetro defaultButton especificado no es un miembro de MessageBoxDefaultButton.

Se intentó mostrar MessageBox en un proceso que no se está ejecutando en el modo de interacción con el usuario. Esto se especifica mediante la propiedad UserInteractive.

options contiene tanto DefaultDesktopOnly como ServiceNotification.

o bien

buttons especificó una combinación no válida de MessageBoxButtons.

Ejemplos

En el ejemplo de código siguiente se muestra cómo mostrar un cuadro de mensaje primario en la ventana principal. El cuadro de mensaje muestra un botón Ayuda. Cuando el usuario hace clic en el botón Ayuda, se abre el Mspaint.chm archivo de Ayuda y se muestra el tema identificado por la mspaint.chm::/paint_brush.htm palabra clave . El ejemplo requiere que se instale el Mspaint.chm archivo de Ayuda.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
System::Windows::Forms::DialogResult r8 = MessageBox::Show( this, "Message with Help file and keyword.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", "mspaint.chm::/paint_brush.htm" );
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
DialogResult r8 = MessageBox.Show (this, "Message with Help file and keyword.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 0, 
                                   "mspaint.chm", 
                                   "mspaint.chm::/paint_brush.htm");
' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file, 
' and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
' associated topic.
Dim r8 As DialogResult = MessageBox.Show(Me, "Message with Help file and keyword.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, 0, _
                                   "mspaint.chm", _
                                   "mspaint.chm::/paint_brush.htm")

Comentarios

Un cuadro de mensaje es un cuadro de diálogo modal, lo que significa que no se puede producir ninguna entrada (clic de teclado o mouse), excepto en los objetos del formulario modal. El programa debe ocultar o cerrar un formulario modal (normalmente en respuesta a alguna acción del usuario) antes de que se pueda producir la entrada en otro formulario. Puede usar el owner parámetro para especificar un objeto determinado, que implementa la IWin32Window interfaz , que servirá como propietario de nivel superior del cuadro de diálogo.

Cuando el usuario hace clic en el botón Ayuda, se abre el archivo de Ayuda especificado en el helpFilePath parámetro y se muestra el tema de palabra clave Help identificado por el keyword parámetro . El formulario que posee el cuadro de mensaje (o el formulario activo) también recibe el HelpRequested evento.

Consulte también

Se aplica a

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Muestra un cuadro de mensaje con el texto, el título, los botones, el icono, el botón predeterminado, las opciones y el botón Ayuda especificados, que usa el archivo de Ayuda, el objeto HelpNavigator y el tema de la Ayuda indicados.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator, System::Object ^ param);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object param);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object? param);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator * obj -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator, param As Object) As DialogResult

Parámetros

text
String

Texto que se va a mostrar en el cuadro de mensaje.

caption
String

Texto que se va a mostrar en la barra de título del cuadro de mensaje.

buttons
MessageBoxButtons

Uno de los valores MessageBoxButtons que especifica qué botones se mostrarán en el cuadro de mensaje.

icon
MessageBoxIcon

Uno de los valores de MessageBoxIcon que especifica qué icono se mostrará en el cuadro de mensaje.

defaultButton
MessageBoxDefaultButton

Uno de los valores de MessageBoxDefaultButton que especifica cuál es el botón predeterminado del cuadro de mensaje.

options
MessageBoxOptions

Uno de los valores de MessageBoxOptions que especifica las opciones de pantalla y asociación que se usará para el cuadro de mensaje. Puede transferir 0 si desea usar los valores predeterminados.

helpFilePath
String

Ruta de acceso y nombre del archivo de Ayuda que se va a mostrar cuando el usuario haga clic en el botón Ayuda.

navigator
HelpNavigator

Uno de los valores de HelpNavigator.

param
Object

Identificador numérico del tema de Ayuda que se va a mostrar cuando el usuario haga clic en el botón Ayuda.

Devoluciones

Uno de los valores de DialogResult.

Excepciones

buttons no es un miembro de MessageBoxButtons.

o bien

icon no es un miembro de MessageBoxIcon.

o bien

El parámetro defaultButton especificado no es un miembro de MessageBoxDefaultButton.

Se intentó mostrar MessageBox en un proceso que no se está ejecutando en el modo de interacción con el usuario. Esto se especifica mediante la propiedad UserInteractive.

options contiene tanto DefaultDesktopOnly como ServiceNotification.

o bien

buttons especificó una combinación no válida de MessageBoxButtons.

Ejemplos

En el ejemplo de código siguiente se muestra cómo mostrar un cuadro de mensaje con un botón Ayuda. Cuando el usuario hace clic en el botón Ayuda, se abre el Mspaint.chm archivo de Ayuda y se muestra la pestaña Índice de ayuda y el tema identificado por la ovals palabra clave . El ejemplo requiere que se instale el Mspaint.chm archivo de Ayuda.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
System::Windows::Forms::DialogResult r5 = MessageBox::Show( "Message with Help file and Help navigator with additional parameter.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::KeywordIndex, "ovals" );
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
DialogResult r5 = MessageBox.Show ("Message with Help file and Help navigator with additional parameter.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.KeywordIndex, "ovals");
' Display a message box. The Help button opens the Mspaint.chm Help file, 
' shows index with the "ovals" keyword selected, and displays the
' associated topic.
Dim r5 As DialogResult = MessageBox.Show("Message with Help file and Help navigator with additional parameter.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.KeywordIndex, "ovals")

Comentarios

Un cuadro de mensaje es un cuadro de diálogo modal, lo que significa que no se puede producir ninguna entrada (clic de teclado o mouse), excepto en los objetos del formulario modal. El programa debe ocultar o cerrar un formulario modal (normalmente en respuesta a alguna acción del usuario) antes de que se pueda producir la entrada en otro formulario.

Cuando el usuario hace clic en el botón Ayuda, se abre el archivo de Ayuda especificado en el helpFilePath parámetro y se muestra el contenido de ayuda identificado por el navigator parámetro . El formulario que posee el cuadro de mensaje (o el formulario activo) también recibe el HelpRequested evento.

Los archivos de ayuda compilados proporcionan vínculos de tabla de contenido, índice, búsqueda y palabra clave en las páginas. Puede usar los siguientes valores para navigator: TableOfContents, Find, Indexo Topic.

Puede usar param para proporcionar un refinamiento adicional del Topic comando. Si el valor especificado en el navigator parámetro es TableOfContents, Indexo Find, este valor debe ser null. Si el navigator parámetro hace referencia a Topic, este valor debe hacer referencia a un objeto que contiene el valor numérico del tema que se va a mostrar.

El helpFilePath parámetro puede tener el formato C:\path\sample.chm o /folder/file.htm.

Consulte también

Se aplica a

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Muestra un cuadro de mensaje con el texto, el título, los botones, el icono, el botón predeterminado, las opciones y el botón Ayuda especificados, que usa el archivo de Ayuda indicado.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String) As DialogResult

Parámetros

owner
IWin32Window

Implementación del IWin32Window que será propietario del cuadro de diálogo modal.

text
String

Texto que se va a mostrar en el cuadro de mensaje.

caption
String

Texto que se va a mostrar en la barra de título del cuadro de mensaje.

buttons
MessageBoxButtons

Uno de los valores MessageBoxButtons que especifica qué botones se mostrarán en el cuadro de mensaje.

icon
MessageBoxIcon

Uno de los valores de MessageBoxIcon que especifica qué icono se mostrará en el cuadro de mensaje.

defaultButton
MessageBoxDefaultButton

Uno de los valores de MessageBoxDefaultButton que especifica cuál es el botón predeterminado del cuadro de mensaje.

options
MessageBoxOptions

Uno de los valores de MessageBoxOptions que especifica las opciones de pantalla y asociación que se usará para el cuadro de mensaje. Puede transferir 0 si desea usar los valores predeterminados.

helpFilePath
String

Ruta de acceso y nombre del archivo de Ayuda que se va a mostrar cuando el usuario haga clic en el botón Ayuda.

Devoluciones

Uno de los valores de DialogResult.

Excepciones

buttons no es un miembro de MessageBoxButtons.

o bien

icon no es un miembro de MessageBoxIcon.

o bien

El parámetro defaultButton especificado no es un miembro de MessageBoxDefaultButton.

Se intentó mostrar MessageBox en un proceso que no se está ejecutando en el modo de interacción con el usuario. Esto se especifica mediante la propiedad UserInteractive.

options contiene tanto DefaultDesktopOnly como ServiceNotification.

o bien

buttons especificó una combinación no válida de MessageBoxButtons.

Ejemplos

En el ejemplo de código siguiente se muestra cómo mostrar un cuadro de mensaje que se ha primario en el formulario principal. El cuadro de mensaje muestra un botón Ayuda. Cuando el usuario hace clic en el botón Ayuda, se abre el Mspaint.chm archivo de Ayuda. El ejemplo requiere que se instale el Mspaint.chm archivo de Ayuda.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file.
System::Windows::Forms::DialogResult r2 = MessageBox::Show( this, "Message with Help file.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm" );
// Display a message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file.
DialogResult r2 = MessageBox.Show (this, "Message with Help file.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, 
                                   "mspaint.chm");
' Display a message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file.
Dim r2 As DialogResult = MessageBox.Show(Me, "Message with Help file.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, _
                                   "mspaint.chm")

Comentarios

Un cuadro de mensaje es un cuadro de diálogo modal, lo que significa que no se puede producir ninguna entrada (clic de teclado o mouse), excepto en los objetos del formulario modal. El programa debe ocultar o cerrar un formulario modal (normalmente en respuesta a alguna acción del usuario) antes de que se pueda producir la entrada en otro formulario. Puede usar el owner parámetro para especificar un objeto determinado, que implementa la IWin32Window interfaz , que servirá como la ventana de nivel superior y el propietario del cuadro de diálogo.

Cuando el usuario hace clic en el botón Ayuda, se abre el archivo de Ayuda especificado en el helpFilePath parámetro . El formulario que posee el cuadro de mensaje (o el formulario activo) también recibe el HelpRequested evento.

El helpFilePath parámetro puede tener el formato C:\path\sample.chm o /folder/file.htm.

Consulte también

Se aplica a

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

Muestra un cuadro de mensaje con el texto, el título, los botones, el icono, el botón predeterminado, las opciones y el botón Ayuda especificados, que usa el archivo de Ayuda y el objeto HelpNavigator indicados.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator) As DialogResult

Parámetros

text
String

Texto que se va a mostrar en el cuadro de mensaje.

caption
String

Texto que se va a mostrar en la barra de título del cuadro de mensaje.

buttons
MessageBoxButtons

Uno de los valores MessageBoxButtons que especifica qué botones se mostrarán en el cuadro de mensaje.

icon
MessageBoxIcon

Uno de los valores de MessageBoxIcon que especifica qué icono se mostrará en el cuadro de mensaje.

defaultButton
MessageBoxDefaultButton

Uno de los valores de MessageBoxDefaultButton que especifica cuál es el botón predeterminado del cuadro de mensaje.

options
MessageBoxOptions

Uno de los valores de MessageBoxOptions que especifica las opciones de pantalla y asociación que se usará para el cuadro de mensaje. Puede transferir 0 si desea usar los valores predeterminados.

helpFilePath
String

Ruta de acceso y nombre del archivo de Ayuda que se va a mostrar cuando el usuario haga clic en el botón Ayuda.

navigator
HelpNavigator

Uno de los valores de HelpNavigator.

Devoluciones

Uno de los valores de DialogResult.

Excepciones

buttons no es un miembro de MessageBoxButtons.

o bien

icon no es un miembro de MessageBoxIcon.

o bien

El parámetro defaultButton especificado no es un miembro de MessageBoxDefaultButton.

Se intentó mostrar MessageBox en un proceso que no se está ejecutando en el modo de interacción con el usuario. Esto se especifica mediante la propiedad UserInteractive.

options contiene tanto DefaultDesktopOnly como ServiceNotification.

o bien

buttons especificó una combinación no válida de MessageBoxButtons.

Ejemplos

En el ejemplo de código siguiente se muestra cómo mostrar un cuadro de mensaje con un botón Ayuda. Cuando el usuario hace clic en el botón Ayuda, se abre el Mspaint.chm archivo de Ayuda y se muestra la pestaña Índice de ayuda. El ejemplo requiere que se instale el Mspaint.chm archivo de Ayuda.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box. The Help button opens 
// the Mspaint.chm Help file and shows the Help contents 
// on the Index tab.
System::Windows::Forms::DialogResult r3 = MessageBox::Show( "Message with Help file and Help navigator.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::Index );
// Display a message box. The Help button opens 
// the Mspaint.chm Help file and shows the Help contents 
// on the Index tab.
DialogResult r3 = MessageBox.Show ("Message with Help file and Help navigator.", 
                                   "Help Caption", MessageBoxButtons.OK,
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.Index);
' Display a message box. The Help button opens 
' the Mspaint.chm Help file and shows the Help contents 
' on the Index tab.
Dim r3 As DialogResult = MessageBox.Show("Message with Help file and Help navigator.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.Index)

Comentarios

Un cuadro de mensaje es un cuadro de diálogo modal, lo que significa que no se puede producir ninguna entrada (clic de teclado o mouse), excepto en los objetos del formulario modal. El programa debe ocultar o cerrar un formulario modal (normalmente en respuesta a alguna acción del usuario) antes de que se pueda producir la entrada en otro formulario.

Cuando el usuario hace clic en el botón Ayuda, se abre el archivo de ayuda especificado en el helpFilePath parámetro y se muestra el contenido de ayuda identificado por el navigator parámetro . El formulario que posee el cuadro de mensaje (o el formulario activo) también recibe el HelpRequested evento.

Los archivos de Ayuda compilados proporcionan vínculos de tabla de contenido, índice, búsqueda y palabra clave en páginas. Puede usar los siguientes valores para navigator: TableOfContents, Find, Indexo Topic.

El helpFilePath parámetro puede tener el formato C:\path\sample.chm o /folder/file.htm.

Consulte también

Se aplica a

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

Muestra un cuadro de mensaje con el texto, el título, los botones, el icono, el botón predeterminado, las opciones y el botón Ayuda especificados, que usa el archivo de Ayuda y la palabra clave de la Ayuda indicados.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::String ^ keyword);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, keyword As String) As DialogResult

Parámetros

text
String

Texto que se va a mostrar en el cuadro de mensaje.

caption
String

Texto que se va a mostrar en la barra de título del cuadro de mensaje.

buttons
MessageBoxButtons

Uno de los valores MessageBoxButtons que especifica qué botones se mostrarán en el cuadro de mensaje.

icon
MessageBoxIcon

Uno de los valores de MessageBoxIcon que especifica qué icono se mostrará en el cuadro de mensaje.

defaultButton
MessageBoxDefaultButton

Uno de los valores de MessageBoxDefaultButton que especifica cuál es el botón predeterminado del cuadro de mensaje.

options
MessageBoxOptions

Uno de los valores de MessageBoxOptions que especifica las opciones de pantalla y asociación que se usará para el cuadro de mensaje. Puede transferir 0 si desea usar los valores predeterminados.

helpFilePath
String

Ruta de acceso y nombre del archivo de Ayuda que se va a mostrar cuando el usuario haga clic en el botón Ayuda.

keyword
String

Palabra clave de la Ayuda que se va a mostrar cuando el usuario haga clic en botón Ayuda.

Devoluciones

Uno de los valores de DialogResult.

Excepciones

buttons no es un miembro de MessageBoxButtons.

o bien

icon no es un miembro de MessageBoxIcon.

o bien

El parámetro defaultButton especificado no es un miembro de MessageBoxDefaultButton.

Se intentó mostrar MessageBox en un proceso que no se está ejecutando en el modo de interacción con el usuario. Esto se especifica mediante la propiedad UserInteractive.

options contiene tanto DefaultDesktopOnly como ServiceNotification.

o bien

buttons especificó una combinación no válida de MessageBoxButtons.

Ejemplos

En el ejemplo de código siguiente se muestra cómo mostrar un cuadro de mensaje con un botón Ayuda. Cuando el usuario hace clic en el botón Ayuda, se abre el Mspaint.chm archivo de Ayuda y se muestra el tema identificado por la mspaint.chm::/paint_brush.htm palabra clave . El ejemplo requiere que se instale el Mspaint.chm archivo de Ayuda.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
System::Windows::Forms::DialogResult r7 = MessageBox::Show( "Message with Help file and keyword.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", "mspaint.chm::/paint_brush.htm" );
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
DialogResult r7 = MessageBox.Show ("Message with Help file and keyword.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 0, 
                                   "mspaint.chm", 
                                   "mspaint.chm::/paint_brush.htm");
' Display a message box. The Help button opens the Mspaint.chm Help file, 
' and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
' associated topic.
Dim r7 As DialogResult = MessageBox.Show("Message with Help file and keyword.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, 0, _
                                   "mspaint.chm", _
                                   "mspaint.chm::/paint_brush.htm")

Comentarios

Un cuadro de mensaje es un cuadro de diálogo modal, lo que significa que no se puede producir ninguna entrada (teclado o clic del mouse), excepto en los objetos del formulario modal. El programa debe ocultar o cerrar un formulario modal (normalmente en respuesta a alguna acción del usuario) antes de que se pueda producir la entrada a otro formulario.

Cuando el usuario hace clic en el botón Ayuda, se abre el archivo de Ayuda especificado en el helpFilePath parámetro y se muestra el tema de palabra clave help identificado por el keyword parámetro . El formulario que posee el cuadro de mensaje (o el formulario activo) también recibe el HelpRequested evento .

Consulte también

Se aplica a

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Muestra un cuadro de mensaje delante del objeto especificado y con el texto, título, botones, icono, botón predeterminado y opciones especificados.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions) As DialogResult

Parámetros

owner
IWin32Window

Implementación del IWin32Window que será propietario del cuadro de diálogo modal.

text
String

Texto que se va a mostrar en el cuadro de mensaje.

caption
String

Texto que se va a mostrar en la barra de título del cuadro de mensaje.

buttons
MessageBoxButtons

Uno de los valores MessageBoxButtons que especifica qué botones se mostrarán en el cuadro de mensaje.

icon
MessageBoxIcon

Uno de los valores de MessageBoxIcon que especifica qué icono se mostrará en el cuadro de mensaje.

defaultButton
MessageBoxDefaultButton

Uno de los valores de MessageBoxDefaultButton que especifica cuál es el botón predeterminado del cuadro de mensaje.

options
MessageBoxOptions

Uno de los valores de MessageBoxOptions que especifica las opciones de pantalla y asociación que se usará para el cuadro de mensaje. Puede transferir 0 si desea usar los valores predeterminados.

Devoluciones

Uno de los valores de DialogResult.

Excepciones

buttons no es un miembro de MessageBoxButtons.

o bien

icon no es un miembro de MessageBoxIcon.

o bien

defaultButton no es un miembro de MessageBoxDefaultButton.

Se intentó mostrar MessageBox en un proceso que no se está ejecutando en el modo de interacción con el usuario. Esto se especifica mediante la propiedad UserInteractive.

options contiene tanto DefaultDesktopOnly como ServiceNotification.

o bien

options especificó DefaultDesktopOnly o ServiceNotification, y especificó un valor en el parámetro owner. Estas dos opciones sólo se deben usar si invoca la versión de este método que no toma un parámetro owner.

o bien

buttons especificó una combinación no válida de MessageBoxButtons.

Ejemplos

En el ejemplo de código siguiente se muestra cómo mostrar un MessageBox objeto con las opciones admitidas por esta sobrecarga de Show. Después de comprobar que una variable de cadena, ServerName, está vacía, el ejemplo muestra un MessageBox, que ofrece al usuario la opción para cancelar la operación. Si el Show valor devuelto del método se evalúa como Yes, el formulario que muestra MessageBox se cierra.

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry2()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Comentarios

Puede usar el owner parámetro para especificar un objeto determinado, que implementa la IWin32Window interfaz , que servirá como ventana de nivel superior y propietario del cuadro de diálogo. Un cuadro de mensaje es un cuadro de diálogo modal, lo que significa que no se puede producir ninguna entrada (teclado o clic del mouse), excepto en los objetos del formulario modal. El programa debe ocultar o cerrar un formulario modal (normalmente en respuesta a alguna acción del usuario) antes de que se pueda producir la entrada a otro formulario.

Puede tener un máximo de tres botones en el cuadro de mensaje.

Consulte también

Se aplica a

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

Muestra un cuadro de mensaje con el texto, el título, los botones, el icono, el botón predeterminado, las opciones y el botón Ayuda especificados, que usa el archivo de Ayuda indicado.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String) As DialogResult

Parámetros

text
String

Texto que se va a mostrar en el cuadro de mensaje.

caption
String

Texto que se va a mostrar en la barra de título del cuadro de mensaje.

buttons
MessageBoxButtons

Uno de los valores MessageBoxButtons que especifica qué botones se mostrarán en el cuadro de mensaje.

icon
MessageBoxIcon

Uno de los valores de MessageBoxIcon que especifica qué icono se mostrará en el cuadro de mensaje.

defaultButton
MessageBoxDefaultButton

Uno de los valores de MessageBoxDefaultButton que especifica cuál es el botón predeterminado del cuadro de mensaje.

options
MessageBoxOptions

Uno de los valores de MessageBoxOptions que especifica las opciones de pantalla y asociación que se usará para el cuadro de mensaje. Puede transferir 0 si desea usar los valores predeterminados.

helpFilePath
String

Ruta de acceso y nombre del archivo de Ayuda que se va a mostrar cuando el usuario haga clic en el botón Ayuda.

Devoluciones

Uno de los valores de DialogResult.

Excepciones

buttons no es un miembro de MessageBoxButtons.

o bien

icon no es un miembro de MessageBoxIcon.

o bien

El parámetro defaultButton especificado no es un miembro de MessageBoxDefaultButton.

Se intentó mostrar MessageBox en un proceso que no se está ejecutando en el modo de interacción con el usuario. Esto se especifica mediante la propiedad UserInteractive.

options contiene tanto DefaultDesktopOnly como ServiceNotification.

o bien

buttons especificó una combinación no válida de MessageBoxButtons.

Ejemplos

En el ejemplo de código siguiente se muestra cómo mostrar un cuadro de mensaje con un botón Ayuda. Cuando el usuario hace clic en el botón Ayuda, se abre el Mspaint.chm archivo de Ayuda. El ejemplo requiere que se instale el Mspaint.chm archivo de Ayuda.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box with a help button. 
// The Help button opens the Mspaint.chm Help file.
System::Windows::Forms::DialogResult r1 = MessageBox::Show( "Message with Help file.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm" );
// Display a message box with a help button. 
// The Help button opens the Mspaint.chm Help file.
DialogResult r1 = MessageBox.Show ("Message with Help file.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, 
                                   "mspaint.chm");
' Display a message box with a help button. 
' The Help button opens the Mspaint.chm Help file.
Dim r1 As DialogResult = MessageBox.Show("Message with Help file.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, _
                                   "mspaint.chm")

Comentarios

Un cuadro de mensaje es un cuadro de diálogo modal, lo que significa que no se puede producir ninguna entrada (teclado o clic del mouse), excepto en los objetos del formulario modal. El programa debe ocultar o cerrar un formulario modal (normalmente en respuesta a alguna acción del usuario) antes de que se pueda producir la entrada a otro formulario.

Cuando el usuario hace clic en el botón Ayuda, se abre el archivo de Ayuda especificado en el helpFilePath parámetro . El formulario que posee el cuadro de mensaje (o el formulario activo) también recibe el HelpRequested evento .

El helpFilePath parámetro puede tener el formato C:\path\sample.chm o /folder/file.htm.

Consulte también

Se aplica a

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)

Muestra un cuadro de mensaje con el texto, el título, los botones, el icono, el botón predeterminado, las opciones y el botón Ayuda especificados.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, bool displayHelpButton);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, bool displayHelpButton);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, bool displayHelpButton);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * bool -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, displayHelpButton As Boolean) As DialogResult

Parámetros

text
String

Texto que se va a mostrar en el cuadro de mensaje.

caption
String

Texto que se va a mostrar en la barra de título del cuadro de mensaje.

buttons
MessageBoxButtons

Uno de los valores MessageBoxButtons que especifica qué botones se mostrarán en el cuadro de mensaje.

icon
MessageBoxIcon

Uno de los valores de MessageBoxIcon que especifica qué icono se mostrará en el cuadro de mensaje.

defaultButton
MessageBoxDefaultButton

Uno de los valores de MessageBoxDefaultButton que especifica cuál es el botón predeterminado del cuadro de mensaje.

options
MessageBoxOptions

Uno de los valores de MessageBoxOptions que especifica las opciones de pantalla y asociación que se usará para el cuadro de mensaje. Puede transferir 0 si desea usar los valores predeterminados.

displayHelpButton
Boolean

Es true para mostrar el botón Ayuda; en caso contrario, es false. De manera predeterminada, es false.

Devoluciones

Uno de los valores de DialogResult.

Excepciones

buttons no es un miembro de MessageBoxButtons.

o bien

icon no es un miembro de MessageBoxIcon.

o bien

El parámetro defaultButton especificado no es un miembro de MessageBoxDefaultButton.

Se intentó mostrar MessageBox en un proceso que no se está ejecutando en el modo de interacción con el usuario. Esto se especifica mediante la propiedad UserInteractive.

options contiene tanto DefaultDesktopOnly como ServiceNotification.

o bien

buttons especificó una combinación no válida de MessageBoxButtons.

Ejemplos

En el ejemplo de código siguiente se muestra cómo mostrar un cuadro de mensaje con un botón Ayuda, controlar el Control.HelpRequested evento y mostrar una ventana de ayuda personalizada en respuesta al evento.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box with a Help button. Show a custom Help window
// by handling the HelpRequested event.
System::Windows::Forms::DialogResult AlertMessageWithCustomHelpWindow()
{
   
   // Handle the HelpRequested event for the following message.
   this->HelpRequested += gcnew System::Windows::Forms::HelpEventHandler( this, &Form1::Form1_HelpRequested );
   this->Tag = "Message with Help button.";
   
   // Show a message box with OK and Help buttons.
   System::Windows::Forms::DialogResult r = MessageBox::Show( "Message with Help button.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, true );
   
   // Remove the HelpRequested event handler to keep the event
   // from being handled for other message boxes.
   this->HelpRequested -= gcnew System::Windows::Forms::HelpEventHandler( this, &Form1::Form1_HelpRequested );
   
   // Return the dialog box result.
   return r;
}

void Form1_HelpRequested( System::Object^ sender, System::Windows::Forms::HelpEventArgs^ hlpevent )
{
   
   // Create a custom Help window in response to the HelpRequested event.
   Form^ helpForm = gcnew Form;
   
   // Set up the form position, size, and title caption.
   helpForm->StartPosition = FormStartPosition::Manual;
   helpForm->Size = System::Drawing::Size( 200, 400 );
   helpForm->DesktopLocation = Point(this->DesktopBounds.X + this->Size.Width,this->DesktopBounds.Top);
   helpForm->Text = "Help Form";
   
   // Create a label to contain the Help text.
   Label^ helpLabel = gcnew Label;
   
   // Add the label to the form and set its text.
   helpForm->Controls->Add( helpLabel );
   helpLabel->Dock = DockStyle::Fill;
   
   // Use the sender parameter to identify the context of the Help request.
   // The parameter must be cast to the Control type to get the Tag property.
   Control^ senderControl = dynamic_cast<Control^>(sender);
   helpLabel->Text = String::Format( "Help information shown in response to user action on the '{0}' message.", dynamic_cast<String^>(senderControl->Tag) );
   
   // Set the Help form to be owned by the main form. This helps
   // to ensure that the Help form is disposed of.
   this->AddOwnedForm( helpForm );
   
   // Show the custom Help window.
   helpForm->Show();
   
   // Indicate that the HelpRequested event is handled.
   hlpevent->Handled = true;
}
// Display a message box with a Help button. Show a custom Help window
// by handling the HelpRequested event.
private DialogResult AlertMessageWithCustomHelpWindow ()
{
    // Handle the HelpRequested event for the following message.
    this.HelpRequested += new System.Windows.Forms.HelpEventHandler (this.Form1_HelpRequested);

    this.Tag = "Message with Help button.";

    // Show a message box with OK and Help buttons.
    DialogResult r = MessageBox.Show ("Message with Help button.", 
                                      "Help Caption", MessageBoxButtons.OK, 
                                      MessageBoxIcon.Question, 
                                      MessageBoxDefaultButton.Button1, 
                                      0, true);

    // Remove the HelpRequested event handler to keep the event
    // from being handled for other message boxes.
    this.HelpRequested -= new System.Windows.Forms.HelpEventHandler (this.Form1_HelpRequested);

    // Return the dialog box result.
    return r;
}

private void Form1_HelpRequested (System.Object sender, System.Windows.Forms.HelpEventArgs hlpevent)
{
    // Create a custom Help window in response to the HelpRequested event.
    Form helpForm = new Form ();

    // Set up the form position, size, and title caption.
    helpForm.StartPosition = FormStartPosition.Manual;
    helpForm.Size = new Size (200, 400);
    helpForm.DesktopLocation = new Point (this.DesktopBounds.X + 
                                          this.Size.Width, 
                                          this.DesktopBounds.Top);
    helpForm.Text = "Help Form";

    // Create a label to contain the Help text.
    Label helpLabel = new Label ();

    // Add the label to the form and set its text.
    helpForm.Controls.Add (helpLabel);
    helpLabel.Dock = DockStyle.Fill;

    // Use the sender parameter to identify the context of the Help request.
    // The parameter must be cast to the Control type to get the Tag property.
    Control senderControl = sender as Control;

    helpLabel.Text = "Help information shown in response to user action on the '" + 
                      (string)senderControl.Tag + "' message.";

    // Set the Help form to be owned by the main form. This helps
    // to ensure that the Help form is disposed of.
    this.AddOwnedForm (helpForm);

    // Show the custom Help window.
    helpForm.Show ();

    // Indicate that the HelpRequested event is handled.
    hlpevent.Handled = true;
}
' Display a message box with a Help button. Show a custom Help window
' by handling the HelpRequested event.
Private Function AlertMessageWithCustomHelpWindow() As DialogResult

    ' Handle the HelpRequested event for the following message.
    AddHandler Me.HelpRequested, AddressOf Me.Form1_HelpRequested

    Me.Tag = "Message with Help button."

    ' Show a message box with OK and Help buttons.
    Dim r As DialogResult = MessageBox.Show("Message with Help button.", _
                                          "Help Caption", MessageBoxButtons.OK, _
                                          MessageBoxIcon.Question, _
                                          MessageBoxDefaultButton.Button1, _
                                          0, True)

    ' Remove the HelpRequested event handler to keep the event
    ' from being handled for other message boxes.
    RemoveHandler Me.HelpRequested, AddressOf Me.Form1_HelpRequested

    ' Return the dialog box result.
    Return r
End Function

Private Sub Form1_HelpRequested(ByVal sender As System.Object, ByVal hlpevent As System.Windows.Forms.HelpEventArgs)

    ' Create a custom Help window in response to the HelpRequested event.
    Dim helpForm As Form = New Form

    ' Set up the form position, size, and title caption.
    With helpForm
        .StartPosition = FormStartPosition.Manual
        .Size = New Size(200, 400)
        .DesktopLocation = New Point(Me.DesktopBounds.X + _
                                     Me.Size.Width, Me.DesktopBounds.Top)
        .Text = "Help Form"
    End With

    ' Create a label to contain the Help text.
    Dim helpLabel As Label = New Label

    ' Add the label to the form and set its text.
    helpForm.Controls.Add(helpLabel)
    helpLabel.Dock = DockStyle.Fill

    ' Use the sender parameter to identify the context of the Help request.
    ' The parameter must be cast to the Control type to get the Tag property.
    Dim senderControl As Control = CType(sender, Control)

    helpLabel.Text = "Help information shown in response to user action on the '" & _
                      CStr(senderControl.Tag) & "' message."

    ' Set the Help form to be owned by the main form. This helps
    ' to ensure that the Help form is disposed of.
    Me.AddOwnedForm(helpForm)

    ' Show the custom Help window.
    helpForm.Show()

    ' Indicate that the HelpRequested event is handled.
    hlpevent.Handled = True
End Sub

Comentarios

Un cuadro de mensaje es un cuadro de diálogo modal, lo que significa que no se puede producir ninguna entrada (teclado o clic del mouse), excepto en los objetos del formulario modal. El programa debe ocultar o cerrar un formulario modal (normalmente en respuesta a alguna acción del usuario) antes de que se pueda producir la entrada a otro formulario.

Cuando el usuario hace clic en el botón Ayuda, el formulario que posee el cuadro de mensaje (o el formulario activo) recibe el HelpRequested evento. Controle el HelpRequested evento para realizar acciones de Ayuda personalizadas.

Consulte también

Se aplica a

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

Muestra un cuadro de mensaje con el texto, el título, los botones, el icono, el botón predeterminado, las opciones y el botón Ayuda especificados, que usa el archivo de Ayuda y el objeto HelpNavigator indicados.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator) As DialogResult

Parámetros

owner
IWin32Window

Implementación del IWin32Window que será propietario del cuadro de diálogo modal.

text
String

Texto que se va a mostrar en el cuadro de mensaje.

caption
String

Texto que se va a mostrar en la barra de título del cuadro de mensaje.

buttons
MessageBoxButtons

Uno de los valores MessageBoxButtons que especifica qué botones se mostrarán en el cuadro de mensaje.

icon
MessageBoxIcon

Uno de los valores de MessageBoxIcon que especifica qué icono se mostrará en el cuadro de mensaje.

defaultButton
MessageBoxDefaultButton

Uno de los valores de MessageBoxDefaultButton que especifica cuál es el botón predeterminado del cuadro de mensaje.

options
MessageBoxOptions

Uno de los valores de MessageBoxOptions que especifica las opciones de pantalla y asociación que se usará para el cuadro de mensaje. Puede transferir 0 si desea usar los valores predeterminados.

helpFilePath
String

Ruta de acceso y nombre del archivo de Ayuda que se va a mostrar cuando el usuario haga clic en el botón Ayuda.

navigator
HelpNavigator

Uno de los valores de HelpNavigator.

Devoluciones

Uno de los valores de DialogResult.

Excepciones

buttons no es un miembro de MessageBoxButtons.

o bien

icon no es un miembro de MessageBoxIcon.

o bien

El parámetro defaultButton especificado no es un miembro de MessageBoxDefaultButton.

Se intentó mostrar MessageBox en un proceso que no se está ejecutando en el modo de interacción con el usuario. Esto se especifica mediante la propiedad UserInteractive.

options contiene tanto DefaultDesktopOnly como ServiceNotification.

o bien

buttons especificó una combinación no válida de MessageBoxButtons.

Ejemplos

En el ejemplo de código siguiente se muestra cómo mostrar un cuadro de mensaje primario en la ventana principal. El cuadro de mensaje muestra un botón Ayuda. Cuando el usuario hace clic en el botón Ayuda, se abre el Mspaint.chm archivo de Ayuda y se muestra la pestaña Índice de ayuda. El ejemplo requiere que se instale el Mspaint.chm archivo de Ayuda.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file
// and shows the Help contents on the Index tab.
System::Windows::Forms::DialogResult r4 = MessageBox::Show( this, "Message with Help file and Help navigator.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::Index );
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file
// and shows the Help contents on the Index tab.
DialogResult r4 = MessageBox.Show (this, 
                                   "Message with Help file and Help navigator.", 
                                   "Help Caption", MessageBoxButtons.OK,
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.Index);
' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file
' and shows the Help contents on the Index tab.
Dim r4 As DialogResult = MessageBox.Show(Me, _
                                      "Message with Help file and Help navigator.", _
                                      "Help Caption", MessageBoxButtons.OK, _
                                      MessageBoxIcon.Question, _
                                      MessageBoxDefaultButton.Button1, _
                                      0, "mspaint.chm", _
                                      HelpNavigator.Index)

Comentarios

Un cuadro de mensaje es un cuadro de diálogo modal, lo que significa que no se puede producir ninguna entrada (teclado o clic del mouse), excepto en los objetos del formulario modal. El programa debe ocultar o cerrar un formulario modal (normalmente en respuesta a alguna acción del usuario) antes de que se pueda producir la entrada a otro formulario. Puede usar el owner parámetro para especificar un objeto determinado, que implementa la IWin32Window interfaz , que servirá como ventana de nivel superior y propietario del cuadro de diálogo.

Cuando el usuario hace clic en el botón Ayuda, se abre el archivo de Ayuda especificado en el helpFilePath parámetro y se muestra el contenido de la Ayuda identificado por el navigator parámetro . El formulario que posee el cuadro de mensaje (o el formulario activo) también recibe el HelpRequested evento .

Los archivos de Ayuda compilados proporcionan vínculos de tabla de contenido, índice, búsqueda y palabra clave en páginas. Puede usar los valores siguientes para navigator: TableOfContents, Find, Indexo Topic.

El helpFilePath parámetro puede tener el formato C:\path\sample.chm o /folder/file.htm.

Consulte también

Se aplica a

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

Muestra un cuadro de mensaje delante del objeto especificado y con el texto, título, botones, icono y botón predeterminado especificados.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton) As DialogResult

Parámetros

owner
IWin32Window

Implementación del IWin32Window que será propietario del cuadro de diálogo modal.

text
String

Texto que se va a mostrar en el cuadro de mensaje.

caption
String

Texto que se va a mostrar en la barra de título del cuadro de mensaje.

buttons
MessageBoxButtons

Uno de los valores MessageBoxButtons que especifica qué botones se mostrarán en el cuadro de mensaje.

icon
MessageBoxIcon

Uno de los valores de MessageBoxIcon que especifica qué icono se mostrará en el cuadro de mensaje.

defaultButton
MessageBoxDefaultButton

Uno de los valores de MessageBoxDefaultButton que especifica cuál es el botón predeterminado del cuadro de mensaje.

Devoluciones

Uno de los valores de DialogResult.

Excepciones

buttons no es un miembro de MessageBoxButtons.

o bien

icon no es un miembro de MessageBoxIcon.

o bien

defaultButton no es un miembro de MessageBoxDefaultButton.

Se intentó mostrar MessageBox en un proceso que no se está ejecutando en el modo de interacción con el usuario. Esto se especifica mediante la propiedad UserInteractive.

Ejemplos

En el ejemplo de código siguiente se muestra cómo mostrar un MessageBox objeto con las opciones admitidas por esta sobrecarga de Show. Después de comprobar que una variable de cadena, ServerName, está vacía, el ejemplo muestra un MessageBox, que ofrece al usuario la opción para cancelar la operación. Si el Show valor devuelto del método se evalúa como Yes, el formulario que muestra MessageBox se cierra.

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry2()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Comentarios

Puede usar el owner parámetro para especificar un objeto determinado, que implementa la IWin32Window interfaz , que servirá como ventana de nivel superior y propietario del cuadro de diálogo. Un cuadro de mensaje es un cuadro de diálogo modal, lo que significa que no se puede producir ninguna entrada (teclado o clic del mouse), excepto en los objetos del formulario modal. El programa debe ocultar o cerrar un formulario modal (normalmente en respuesta a alguna acción del usuario) antes de que se pueda producir la entrada a otro formulario.

Puede tener un máximo de tres botones en el cuadro de mensaje.

Consulte también

Se aplica a

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)

Muestra un cuadro de mensaje delante del objeto especificado y con el texto, título, botones e icono especificados.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon) As DialogResult

Parámetros

owner
IWin32Window

Implementación del IWin32Window que será propietario del cuadro de diálogo modal.

text
String

Texto que se va a mostrar en el cuadro de mensaje.

caption
String

Texto que se va a mostrar en la barra de título del cuadro de mensaje.

buttons
MessageBoxButtons

Uno de los valores MessageBoxButtons que especifica qué botones se mostrarán en el cuadro de mensaje.

icon
MessageBoxIcon

Uno de los valores de MessageBoxIcon que especifica qué icono se mostrará en el cuadro de mensaje.

Devoluciones

Uno de los valores de DialogResult.

Excepciones

buttons no es un miembro de MessageBoxButtons.

o bien

icon no es un miembro de MessageBoxIcon.

Se intentó mostrar MessageBox en un proceso que no se está ejecutando en el modo de interacción con el usuario. Esto se especifica mediante la propiedad UserInteractive.

Ejemplos

En el ejemplo de código siguiente se muestra cómo mostrar un MessageBox objeto con las opciones admitidas por esta sobrecarga de Show. Después de comprobar que una variable de cadena, ServerName, está vacía, el ejemplo muestra un MessageBox, que ofrece al usuario la opción para cancelar la operación. Si el Show valor devuelto del método se evalúa como Yes, el formulario que muestra MessageBox se cierra.

private:
   void validateUserEntry4()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry4()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry4()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, MessageBoxIcon.Question)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Comentarios

Puede usar el owner parámetro para especificar un objeto determinado, que implementa la IWin32Window interfaz , que servirá como ventana de nivel superior y propietario del cuadro de diálogo. Un cuadro de mensaje es un cuadro de diálogo modal, lo que significa que no se puede producir ninguna entrada (teclado o clic del mouse), excepto en los objetos del formulario modal. El programa debe ocultar o cerrar un formulario modal (normalmente en respuesta a alguna acción del usuario) antes de que se pueda producir la entrada a otro formulario.

Puede tener un máximo de tres botones en el cuadro de mensaje.

Consulte también

Se aplica a

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

Muestra un cuadro de mensaje con el texto, el título, los botones, el icono y el botón predeterminado especificados.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton) As DialogResult

Parámetros

text
String

Texto que se va a mostrar en el cuadro de mensaje.

caption
String

Texto que se va a mostrar en la barra de título del cuadro de mensaje.

buttons
MessageBoxButtons

Uno de los valores MessageBoxButtons que especifica qué botones se mostrarán en el cuadro de mensaje.

icon
MessageBoxIcon

Uno de los valores de MessageBoxIcon que especifica qué icono se mostrará en el cuadro de mensaje.

defaultButton
MessageBoxDefaultButton

Uno de los valores de MessageBoxDefaultButton que especifica cuál es el botón predeterminado del cuadro de mensaje.

Devoluciones

Uno de los valores de DialogResult.

Excepciones

buttons no es un miembro de MessageBoxButtons.

o bien

icon no es un miembro de MessageBoxIcon.

o bien

defaultButton no es un miembro de MessageBoxDefaultButton.

Se intentó mostrar MessageBox en un proceso que no se está ejecutando en el modo de interacción con el usuario. Esto se especifica mediante la propiedad UserInteractive.

Ejemplos

En el ejemplo de código siguiente se muestra cómo mostrar un MessageBox objeto con las opciones admitidas por esta sobrecarga de Show. Después de comprobar que una variable de cadena, ServerName, está vacía, el ejemplo muestra un MessageBox con un icono de cuadro de pregunta, lo que ofrece al usuario la opción de cancelar la operación. Si el Show valor devuelto del método se evalúa como Yes, el formulario que muestra MessageBox se cierra.

private:
   void validateUserEntry3()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1 );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry3()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
        MessageBoxIcon.Question, MessageBoxDefaultButton.Button1);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry3()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, MessageBoxIcon.Question, _
            MessageBoxDefaultButton.Button1)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If
End Sub

Comentarios

Puede tener un máximo de tres botones en el cuadro de mensaje.

Consulte también

Se aplica a

Show(IWin32Window, String, String, MessageBoxButtons)

Muestra un cuadro de mensaje delante del objeto especificado y con el texto, título y botones especificados.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons) As DialogResult

Parámetros

owner
IWin32Window

Implementación del IWin32Window que será propietario del cuadro de diálogo modal.

text
String

Texto que se va a mostrar en el cuadro de mensaje.

caption
String

Texto que se va a mostrar en la barra de título del cuadro de mensaje.

buttons
MessageBoxButtons

Uno de los valores MessageBoxButtons que especifica qué botones se mostrarán en el cuadro de mensaje.

Devoluciones

Uno de los valores de DialogResult.

Excepciones

buttons no es un miembro de MessageBoxButtons.

Se intentó mostrar MessageBox en un proceso que no se está ejecutando en el modo de interacción con el usuario. Esto se especifica mediante la propiedad UserInteractive.

Ejemplos

En el ejemplo de código siguiente se muestra cómo mostrar un MessageBox objeto con las opciones admitidas por esta sobrecarga de Show. Después de comprobar que una variable de cadena, ServerName, está vacía, el ejemplo muestra un MessageBox, que ofrece al usuario la opción para cancelar la operación. Si el Show valor devuelto del método se evalúa como Yes, el formulario que muestra MessageBox se cierra.

private:
   void validateUserEntry5()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry5()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry5()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Comentarios

Puede usar el owner parámetro para especificar un objeto determinado, que implementa la IWin32Window interfaz , que servirá como ventana de nivel superior y propietario del cuadro de diálogo. Un cuadro de mensaje es un cuadro de diálogo modal, lo que significa que no se puede producir ninguna entrada (teclado o clic del mouse), excepto en los objetos del formulario modal. El programa debe ocultar o cerrar un formulario modal (normalmente en respuesta a alguna acción del usuario) antes de que se pueda producir la entrada a otro formulario.

Puede tener un máximo de tres botones en el cuadro de mensaje.

Consulte también

Se aplica a

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Muestra un cuadro de mensaje con el texto, el título, los botones y el icono especificados.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon) As DialogResult

Parámetros

text
String

Texto que se va a mostrar en el cuadro de mensaje.

caption
String

Texto que se va a mostrar en la barra de título del cuadro de mensaje.

buttons
MessageBoxButtons

Uno de los valores MessageBoxButtons que especifica qué botones se mostrarán en el cuadro de mensaje.

icon
MessageBoxIcon

Uno de los valores de MessageBoxIcon que especifica qué icono se mostrará en el cuadro de mensaje.

Devoluciones

Uno de los valores de DialogResult.

Excepciones

El parámetro buttons especificado no es un miembro de MessageBoxButtons.

o bien

El parámetro icon especificado no es un miembro de MessageBoxIcon.

Se intentó mostrar MessageBox en un proceso que no se está ejecutando en el modo de interacción con el usuario. Esto se especifica mediante la propiedad UserInteractive.

Ejemplos

En el ejemplo de código siguiente se muestra uno de los Show métodos al controlar el ComboBox.DropDown evento. Para ejecutar el ejemplo, pegue el código siguiente en un formulario y llame al InitializeComboBox método desde el constructor o Load método del formulario.

internal:
   // Declare ComboBox1
   System::Windows::Forms::ComboBox^ ComboBox1;

private:
   // Initialize ComboBox1.
   void InitializeComboBox()
   {
      this->ComboBox1 = gcnew ComboBox;
      this->ComboBox1->Location = System::Drawing::Point( 128, 48 );
      this->ComboBox1->Name = "ComboBox1";
      this->ComboBox1->Size = System::Drawing::Size( 100, 21 );
      this->ComboBox1->TabIndex = 0;
      this->ComboBox1->Text = "Typical";
      array<String^>^ installs = {"Typical","Compact","Custom"};
      ComboBox1->Items->AddRange( installs );
      this->Controls->Add( this->ComboBox1 );
      
      // Hook up the event handler.
      this->ComboBox1->DropDown += gcnew System::EventHandler(
         this, &Form1::ComboBox1_DropDown );
   }

   // Handles the ComboBox1 DropDown event. If the user expands the  
   // drop-down box, a message box will appear, recommending the
   // typical installation.
   void ComboBox1_DropDown( Object^ sender, System::EventArgs^ e )
   {
      MessageBox::Show( "Typical installation is strongly recommended.",
         "Install information", MessageBoxButtons::OK,
         MessageBoxIcon::Information );
   }

// Declare ComboBox1.
internal System.Windows.Forms.ComboBox ComboBox1;

// Initialize ComboBox1.
private void InitializeComboBox()
{
    this.ComboBox1 = new ComboBox();
    this.ComboBox1.Location = new System.Drawing.Point(128, 48);
    this.ComboBox1.Name = "ComboBox1";
    this.ComboBox1.Size = new System.Drawing.Size(100, 21);
    this.ComboBox1.TabIndex = 0;
    this.ComboBox1.Text	= "Typical";
    string[] installs = new string[]{"Typical", "Compact", "Custom"};
    ComboBox1.Items.AddRange(installs);
    this.Controls.Add(this.ComboBox1);
    
    // Hook up the event handler.
    this.ComboBox1.DropDown +=  
        new System.EventHandler(ComboBox1_DropDown);
}

// Handles the ComboBox1 DropDown event. If the user expands the  
// drop-down box, a message box will appear, recommending the
// typical installation.
private void ComboBox1_DropDown(object sender, System.EventArgs e)
{
    MessageBox.Show("Typical installation is strongly recommended.", 
    "Install information", MessageBoxButtons.OK, 
        MessageBoxIcon.Information);
}

' Declare ComboBox1.
Friend WithEvents ComboBox1 As System.Windows.Forms.ComboBox

' Initialize ComboBox1.
Private Sub InitializeComboBox()
    Me.ComboBox1 = New ComboBox
    Me.ComboBox1.Location = New System.Drawing.Point(128, 48)
    Me.ComboBox1.Name = "ComboBox1"
    Me.ComboBox1.Size = New System.Drawing.Size(100, 21)
    Me.ComboBox1.TabIndex = 0
    Me.ComboBox1.Text = "Typical"
    Dim installs() As String = New String() _
        {"Typical", "Compact", "Custom"}
    ComboBox1.Items.AddRange(installs)
    Me.Controls.Add(Me.ComboBox1)
End Sub

' Handles the ComboBox1 DropDown event. If the user expands the  
' drop-down box, a message box will appear, recommending the
' typical installation.
Private Sub ComboBox1_DropDown _ 
    (ByVal sender As Object, ByVal e As System.EventArgs) _ 
    Handles ComboBox1.DropDown
    MessageBox.Show("Typical installation is strongly recommended.", _
    "Install information", MessageBoxButtons.OK, MessageBoxIcon.Information)
End Sub

Comentarios

Puede tener un máximo de tres botones en el cuadro de mensaje.

Consulte también

Se aplica a

Show(IWin32Window, String, String)

Muestra un cuadro de mensaje delante del objeto especificado y con el texto y título especificados.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption);
static member Show : System.Windows.Forms.IWin32Window * string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String) As DialogResult

Parámetros

owner
IWin32Window

Implementación del IWin32Window que será propietario del cuadro de diálogo modal.

text
String

Texto que se va a mostrar en el cuadro de mensaje.

caption
String

Texto que se va a mostrar en la barra de título del cuadro de mensaje.

Devoluciones

Uno de los valores de DialogResult.

Comentarios

Puede usar el owner parámetro para especificar un objeto determinado, que implementa la IWin32Window interfaz , que servirá como la ventana de nivel superior y el propietario del cuadro de diálogo. Un cuadro de mensaje es un cuadro de diálogo modal, lo que significa que no se puede producir ninguna entrada (clic de teclado o mouse), excepto en los objetos del formulario modal. El programa debe ocultar o cerrar un formulario modal (normalmente en respuesta a alguna acción del usuario) antes de que se pueda producir la entrada en otro formulario.

De forma predeterminada, el cuadro de mensaje muestra un botón Aceptar .

Se aplica a

Show(String, String, MessageBoxButtons)

Muestra un cuadro de mensaje con el texto, el título y los botones especificados.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons) As DialogResult

Parámetros

text
String

Texto que se va a mostrar en el cuadro de mensaje.

caption
String

Texto que se va a mostrar en la barra de título del cuadro de mensaje.

buttons
MessageBoxButtons

Uno de los valores MessageBoxButtons que especifica qué botones se mostrarán en el cuadro de mensaje.

Devoluciones

Uno de los valores de DialogResult.

Excepciones

El parámetro buttons especificado no es un miembro de MessageBoxButtons.

Se intentó mostrar MessageBox en un proceso que no se está ejecutando en el modo de interacción con el usuario. Esto se especifica mediante la propiedad UserInteractive.

Ejemplos

En el ejemplo de código siguiente se muestra cómo mostrar con MessageBox las opciones admitidas por esta sobrecarga de Show. Después de comprobar que una variable de cadena, ServerName, está vacía, el ejemplo muestra un MessageBox, que ofrece al usuario la opción para cancelar la operación. Si el Show valor devuelto del método se evalúa como Yes, el formulario que muestra se MessageBox cierra.

private:
   void validateUserEntry()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry()
{
    // Checks the value of the text.
    if(serverName.Text.Length == 0)
    {
        // Initializes the variables to pass to the MessageBox.Show method.
        string message = "You did not enter a server name. Cancel this operation?";
     string caption = "Error Detected in Input";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.
        result = MessageBox.Show(message, caption, buttons);
        if (result == System.Windows.Forms.DialogResult.Yes)
        {
            // Closes the parent form.
            this.Close();
        }
    }
}
Private Sub ValidateUserEntry()
    ' Checks the value of the text.
    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.
        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "Error Detected in Input"
        Dim Buttons As MessageBoxButtons = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays the MessageBox
        Result = MessageBox.Show(Message, Caption, Buttons)

        ' Gets the result of the MessageBox display.
        If Result = System.Windows.Forms.DialogResult.Yes Then
            ' Closes the parent form.
            Me.Close()
        End If
    End If
End Sub

Comentarios

Puede tener un máximo de tres botones en el cuadro de mensaje.

Consulte también

Se aplica a

Show(IWin32Window, String)

Muestra un cuadro de mensaje delante del objeto especificado y con el texto especificado.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text);
static member Show : System.Windows.Forms.IWin32Window * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String) As DialogResult

Parámetros

owner
IWin32Window

Implementación del IWin32Window que será propietario del cuadro de diálogo modal.

text
String

Texto que se va a mostrar en el cuadro de mensaje.

Devoluciones

Uno de los valores de DialogResult.

Comentarios

Puede usar el owner parámetro para especificar un objeto determinado, que implementa la IWin32Window interfaz , que servirá como la ventana de nivel superior y el propietario del cuadro de diálogo. Un cuadro de mensaje es un cuadro de diálogo modal, lo que significa que no se puede producir ninguna entrada (clic de teclado o mouse), excepto en los objetos del formulario modal. El programa debe ocultar o cerrar un formulario modal (normalmente en respuesta a alguna acción del usuario) antes de que se pueda producir la entrada en otro formulario.

De forma predeterminada, el cuadro de mensaje muestra un botón Aceptar . El cuadro de mensaje no contiene un subtítulo en el título.

Se aplica a

Show(String, String)

Muestra un cuadro de mensaje con el texto y el título especificados.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption);
public static System.Windows.Forms.DialogResult Show (string text, string caption);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption);
static member Show : string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String) As DialogResult

Parámetros

text
String

Texto que se va a mostrar en el cuadro de mensaje.

caption
String

Texto que se va a mostrar en la barra de título del cuadro de mensaje.

Devoluciones

Uno de los valores de DialogResult.

Comentarios

De forma predeterminada, el cuadro de mensaje muestra un botón Aceptar .

Se aplica a

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Muestra un cuadro de mensaje con el texto, el título, los botones, el icono, el botón predeterminado y las opciones especificados.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions) As DialogResult

Parámetros

text
String

Texto que se va a mostrar en el cuadro de mensaje.

caption
String

Texto que se va a mostrar en la barra de título del cuadro de mensaje.

buttons
MessageBoxButtons

Uno de los valores MessageBoxButtons que especifica qué botones se mostrarán en el cuadro de mensaje.

icon
MessageBoxIcon

Uno de los valores de MessageBoxIcon que especifica qué icono se mostrará en el cuadro de mensaje.

defaultButton
MessageBoxDefaultButton

Uno de los valores de MessageBoxDefaultButton que especifica cuál es el botón predeterminado del cuadro de mensaje.

options
MessageBoxOptions

Uno de los valores de MessageBoxOptions que especifica las opciones de pantalla y asociación que se usará para el cuadro de mensaje. Puede transferir 0 si desea usar los valores predeterminados.

Devoluciones

Uno de los valores de DialogResult.

Excepciones

buttons no es un miembro de MessageBoxButtons.

o bien

icon no es un miembro de MessageBoxIcon.

o bien

El parámetro defaultButton especificado no es un miembro de MessageBoxDefaultButton.

Se intentó mostrar MessageBox en un proceso que no se está ejecutando en el modo de interacción con el usuario. Esto se especifica mediante la propiedad UserInteractive.

options contiene tanto DefaultDesktopOnly como ServiceNotification.

o bien

buttons especificó una combinación no válida de MessageBoxButtons.

Ejemplos

En el ejemplo de código siguiente se muestra cómo mostrar con MessageBox las opciones admitidas por esta sobrecarga de Show. Después de comprobar que una variable de cadena, ServerName, está vacía, el ejemplo muestra un con un MessageBox icono de cuadro de pregunta, lo que ofrece al usuario la opción de cancelar la operación. En el ejemplo se usa el RightAlign miembro de la MessageBoxOptions enumeración para alinear el texto con el borde derecho del cuadro de diálogo. Si el Show valor devuelto del método se evalúa como Yes, el formulario que muestra se MessageBox cierra.

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry2()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}
Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Comentarios

Puede tener un máximo de tres botones en el cuadro de mensaje.

Consulte también

Se aplica a

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Muestra un cuadro de mensaje con el texto, el título, los botones, el icono, el botón predeterminado, las opciones y el botón Ayuda especificados, que usa el archivo de Ayuda, el objeto HelpNavigator y el tema de la Ayuda indicados.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator, System::Object ^ param);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object param);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object? param);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator * obj -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator, param As Object) As DialogResult

Parámetros

owner
IWin32Window

Implementación del IWin32Window que será propietario del cuadro de diálogo modal.

text
String

Texto que se va a mostrar en el cuadro de mensaje.

caption
String

Texto que se va a mostrar en la barra de título del cuadro de mensaje.

buttons
MessageBoxButtons

Uno de los valores MessageBoxButtons que especifica qué botones se mostrarán en el cuadro de mensaje.

icon
MessageBoxIcon

Uno de los valores de MessageBoxIcon que especifica qué icono se mostrará en el cuadro de mensaje.

defaultButton
MessageBoxDefaultButton

Uno de los valores de MessageBoxDefaultButton que especifica cuál es el botón predeterminado del cuadro de mensaje.

options
MessageBoxOptions

Uno de los valores de MessageBoxOptions que especifica las opciones de pantalla y asociación que se usará para el cuadro de mensaje. Puede transferir 0 si desea usar los valores predeterminados.

helpFilePath
String

Ruta de acceso y nombre del archivo de Ayuda que se va a mostrar cuando el usuario haga clic en el botón Ayuda.

navigator
HelpNavigator

Uno de los valores de HelpNavigator.

param
Object

Identificador numérico del tema de Ayuda que se va a mostrar cuando el usuario haga clic en el botón Ayuda.

Devoluciones

Uno de los valores de DialogResult.

Excepciones

buttons no es un miembro de MessageBoxButtons.

o bien

icon no es un miembro de MessageBoxIcon.

o bien

El parámetro defaultButton especificado no es un miembro de MessageBoxDefaultButton.

Se intentó mostrar MessageBox en un proceso que no se está ejecutando en el modo de interacción con el usuario. Esto se especifica mediante la propiedad UserInteractive.

options contiene tanto DefaultDesktopOnly como ServiceNotification.

o bien

buttons especificó una combinación no válida de MessageBoxButtons.

Ejemplos

En el ejemplo de código siguiente se muestra cómo mostrar un cuadro de mensaje primario en la ventana principal. El cuadro de mensaje muestra un botón Ayuda. Cuando el usuario hace clic en el botón Ayuda, se abre el Mspaint.chm archivo de Ayuda y se muestra la pestaña Índice de ayuda y el tema identificado por la ovals palabra clave . El ejemplo requiere que se instale el Mspaint.chm archivo de Ayuda.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
System::Windows::Forms::DialogResult r6 = MessageBox::Show( this, "Message with Help file and Help navigator with additional parameter.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::KeywordIndex, "ovals" );
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
DialogResult r6 = MessageBox.Show (this, 
                                   "Message with Help file and Help navigator with additional parameter.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.KeywordIndex, "ovals");
' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file, 
' shows index with the "ovals" keyword selected, and displays the
' associated topic.
Dim r6 As DialogResult = MessageBox.Show(Me, _
                                   "Message with Help file and Help navigator with additional parameter.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.KeywordIndex, "ovals")

Comentarios

Un cuadro de mensaje es un cuadro de diálogo modal, lo que significa que no se puede producir ninguna entrada (clic de teclado o mouse), excepto en los objetos del formulario modal. El programa debe ocultar o cerrar un formulario modal (normalmente en respuesta a alguna acción del usuario) antes de que se pueda producir la entrada en otro formulario. Puede usar el owner parámetro para especificar un objeto determinado, que implementa la IWin32Window interfaz , que servirá como ventana de nivel superior y propietario del cuadro de diálogo.

Cuando el usuario hace clic en el botón Ayuda, se abre el archivo de Ayuda especificado en el helpFilePath parámetro y se muestra el contenido de la Ayuda identificado por el navigator parámetro . El formulario que posee el cuadro de mensaje (o el formulario activo) también recibe el HelpRequested evento .

Los archivos de ayuda compilados proporcionan vínculos de tabla de contenido, índice, búsqueda y palabra clave en páginas. Puede usar los valores siguientes para navigator: TableOfContents, Find, Indexo Topic.

Puede usar param para proporcionar un refinamiento adicional del Topic comando. Si el valor especificado en el navigator parámetro es TableOfContents, Indexo Find, este valor debe ser null. Si el navigator parámetro hace referencia a Topic, este valor debe hacer referencia a un objeto que contiene el valor numérico del tema que se va a mostrar.

El helpFilePath parámetro puede tener el formato C:\path\sample.chm o /folder/file.htm.

Consulte también

Se aplica a