MessageBox.Show (Método) (String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

public static DialogResult Show (
	string text,
	string caption,
	MessageBoxButtons buttons,
	MessageBoxIcon icon,
	MessageBoxDefaultButton defaultButton,
	MessageBoxOptions options,
	string helpFilePath
)

public static DialogResult Show (
	String text, 
	String caption, 
	MessageBoxButtons buttons, 
	MessageBoxIcon icon, 
	MessageBoxDefaultButton defaultButton, 
	MessageBoxOptions options, 
	String helpFilePath
)

public static function Show (
	text : String, 
	caption : String, 
	buttons : MessageBoxButtons, 
	icon : MessageBoxIcon, 
	defaultButton : MessageBoxDefaultButton, 
	options : MessageBoxOptions, 
	helpFilePath : String
) : DialogResult

No aplicable.

Parámetros

text

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

caption

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

buttons

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

icon

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

defaultButton

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

options

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

helpFilePath

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

Valor devuelto

Un cuadro de mensaje es un cuadro de diálogo modal, lo que significa que no se pueden proporcionar datos, ni mediante el teclado ni mediante el mouse, salvo en los objetos del formulario modal. El programa debe ocultar o cerrar un formulario modal (normalmente, en respuesta a una acción del usuario) antes de admitir la entrada de datos en otro formulario.

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

El parámetro helpFilePath puede tener la estructura C:\ruta\ejemplo.chm o /carpeta/archivo.htm.

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

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
...

            // 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");

package WindowsApplication1;

import System.*;
import System.Drawing.*;
import System.ComponentModel.*;
import System.Windows.Forms.*;
...

        // 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,(MessageBoxOptions)0,"mspaint.chm");

• UIPermission  para que las ventanas secundarias seguras llamen a este método. Enumeración asociada: UIPermissionWindow.SafeSubWindows.
• WebPermission  para tener acceso a un archivo de ayuda HTML a través de una solicitud HTTP. Enumeración asociada: NetworkAccess.Connect.
• SecurityPermission  para tener acceso a un archivo de ayuda HTML que no proviene de un servidor HTTP. Enumeración asociada: UnmanagedCode.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework