Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método Interaction.MsgBox (Object, MsgBoxStyle, Object)

 

Publicado: noviembre de 2016

Muestra un mensaje en un cuadro de diálogo, espera a que el usuario haga clic en un botón y, a continuación, devuelve un entero que indica el botón que el usuario hizo clic.

Espacio de nombres:   Microsoft.VisualBasic
Ensamblado:  Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)

[HostProtectionAttribute(SecurityAction.LinkDemand, Resources = HostProtectionResource.UI)]
public static MsgBoxResult MsgBox(
	object Prompt,
	MsgBoxStyle Buttons = MsgBoxStyle.OkOnly,
	object Title = null
)

Parámetros

Prompt
Type: System.Object

Obligatorio. String Expresión que se muestra como mensaje en el cuadro de diálogo. La longitud máxima de Prompt es aproximadamente de 1024 caracteres, según el ancho de los caracteres utilizados. Si Prompt consta de más de una línea, puede separar las líneas mediante un carácter de retorno de carro (Chr(13)), un salto de línea (Chr(10)), o una combinación de caracteres o salto de línea del carro (Chr(13) & Chr(10)) entre cada línea.

Buttons
Type: Microsoft.VisualBasic.MsgBoxStyle

Opcional. Expresión numérica que es la suma de valores que especifican el número y tipo de botones para mostrar, el estilo de icono para usar la identidad del botón predeterminado y la modalidad del cuadro de mensaje. Si se omite Buttons, el valor predeterminado es cero.

Title
Type: System.Object

Opcional. String Expresión que se muestra en la barra de título del cuadro de diálogo. Si se omite Title, el nombre de la aplicación se coloca en la barra de título.

Valor devuelto

Type: Microsoft.VisualBasic.MsgBoxResult

Constante

Valor

OK

1

Cancel

2

Abort

3

Retry

4

Ignore

5

Yes

6

No

7

Exception Condition
ArgumentException

Prompt no es un String expresión, o Title no es válido.

InvalidOperationException

Proceso no se está ejecutando en modo interactivo de usuario.

InvalidEnumArgumentException

Uno o más parámetros no son miembros de MsgBoxResult o MsgBoxStyle (enumeración).

Si omite los argumentos posicionales, debe conservar el correspondiente delimitador de coma.

Si el cuadro de diálogo muestra una Cancelar botón presionando la tecla ESC tiene el mismo efecto que hacer clic en Cancelar

Si el cuadro de diálogo contiene un Ayuda botón, se proporciona ayuda contextual para el cuadro de diálogo. Sin embargo, no devuelve ningún valor hasta que se elige uno de los otros botones. En las aplicaciones de Windows Forms, elegir el Ayuda botón ejecuta el HelpRequested evento para el formulario.

System_CAPS_noteNota

El MsgBox requiere la función UIPermission en la SafeTopLevelWindows nivel, lo que puede afectar a su ejecución en situaciones de confianza parcial. Para obtener más información, consulta UIPermission.

El MsgBoxStyle valores de enumeración se enumeran en la tabla siguiente.

Miembro

Valor

Descripción

OKOnly

0

Muestra el botón Aceptar sólo.

OKCancel

1

Muestra Aceptar y cancelar botones.

AbortRetryIgnore

2

Muestra los botones Anular, Reintentar y omitir.

YesNoCancel

3

Muestra Yes, No y cancelar los botones.

YesNo

4

No muestra los botones Sí y.

RetryCancel

5

Muestra los botones Reintentar y Cancelar.

Critical

16

Muestra el icono mensaje crítico.

Question

32

Muestra el icono consulta de advertencia.

Exclamation

48

Muestra el icono de mensaje de advertencia.

Information

64

Muestra el icono mensaje de información.

DefaultButton1

0

Primer botón es el predeterminado.

DefaultButton2

256

Segundo botón es el predeterminado.

DefaultButton3

512

Tercer botón es el predeterminado.

ApplicationModal

0

La aplicación es modal. El usuario debe responder al cuadro de mensaje antes de continuar trabajando en la aplicación actual.

SystemModal

4096

El sistema es modal. Se suspenden todas las aplicaciones hasta que el usuario responda al cuadro de mensaje.

MsgBoxSetForeground

65536

Especifica la ventana del cuadro de mensaje como la ventana de primer plano.

MsgBoxRight

524288

Texto está alineado a la derecha.

MsgBoxRtlReading

1048576

Especifica el texto debe aparecer como derecha a izquierda leer en los sistemas hebreo y árabe.

El primer grupo de valores (de 0 a 5) describe el número y tipo de botones que aparecen en el cuadro de diálogo. El segundo grupo (16, 32, 48, 64) describe el estilo de icono. El tercer grupo (0, 256, 512) determina qué botón es el predeterminado. El cuarto grupo (0, 4096) determina la modalidad del cuadro de mensaje y el quinto grupo especifica si la ventana del cuadro de mensaje es la ventana de primer plano, junto con la alineación y la dirección del texto. Al sumar números para crear un valor final para el Buttons argumento, use sólo un número de cada grupo.

Este ejemplo se utiliza la MsgBox función para mostrar un mensaje de error crítico en un cuadro de diálogo con botones Sí y No. El botón No se especifica como la respuesta predeterminada. Esto se hace mediante la combinación del MsgBox valores constantes en una expresión numérica. En este caso, si se agrega 4 (la combinación de botones Sí/No) y 16 (la mensaje crítico ventana) y 256 (el segundo botón como botón predeterminado) da un total de 276. El valor devuelto por el MsgBox función depende del botón elegido por el usuario: Sí devuelve un valor de 6; No devuelve un valor de 7.

' The following example requires that Option Infer be set to On.

' Define the message you want to see inside the message box.
Dim msg = "Do you want to continue?"

' Display a simple message box.
MsgBox(msg)

' Define a title for the message box.
Dim title = "MsgBox Demonstration"

' Add the title to the display.
MsgBox(msg, , title)

' Now define a style for the message box. In this example, the
' message box will have Yes and No buttons, the default will be
' the No button, and a Critical Message icon will be present.
Dim style = MsgBoxStyle.YesNo Or MsgBoxStyle.DefaultButton2 Or
            MsgBoxStyle.Critical

' Display the message box and save the response, Yes or No.
Dim response = MsgBox(msg, style, title)

' Take some action based on the response.
If response = MsgBoxResult.Yes Then
    MsgBox("YES, continue!!", , title)
Else
    MsgBox("NO, stop!!", , title)
End If

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: