Interaction.MsgBox(Object, MsgBoxStyle, Object) Interaction.MsgBox(Object, MsgBoxStyle, Object) Interaction.MsgBox(Object, MsgBoxStyle, Object) Method

Definición

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 en el que el usuario ha hecho clic.Displays a message in a dialog box, waits for the user to click a button, and then returns an integer indicating which button the user clicked.

public static Microsoft.VisualBasic.MsgBoxResult MsgBox (object Prompt, Microsoft.VisualBasic.MsgBoxStyle Buttons = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, object Title = null);
static member MsgBox : obj * Microsoft.VisualBasic.MsgBoxStyle * obj -> Microsoft.VisualBasic.MsgBoxResult
Public Function MsgBox (Prompt As Object, Optional Buttons As MsgBoxStyle = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, Optional Title As Object = null) As MsgBoxResult

Parámetros

Prompt
Object Object Object

Obligatorio.Required. Expresión de tipo String que se muestra como mensaje en el cuadro de diálogo.String expression displayed as the message in the dialog box. La longitud máxima de Prompt es aproximadamente de 1024 caracteres, dependiendo del ancho de los caracteres utilizados.The maximum length of Prompt is approximately 1024 characters, depending on the width of the characters used. Si Prompt consta de más de una línea, puede separar las líneas con un carácter de retorno de carro (Chr(13)), un carácter de avance de línea (Chr(10)) o una combinación de retorno de carro/avance de línea (Chr(13) & Chr(10)) entre cada línea.If Prompt consists of more than one line, you can separate the lines using a carriage return character (Chr(13)), a line feed character (Chr(10)), or a carriage return/linefeed character combination (Chr(13) & Chr(10)) between each line.

Buttons
MsgBoxStyle MsgBoxStyle MsgBoxStyle

Opcional.Optional. Expresión numérica que es la suma de los valores que especifican el número y el tipo de botones que se van a mostrar, el estilo de icono que se va a utilizar, la identidad del botón predeterminado y la modalidad del cuadro de mensaje.Numeric expression that is the sum of values specifying the number and type of buttons to display, the icon style to use, the identity of the default button, and the modality of the message box. Si se omite Buttons, el valor predeterminado es cero.If you omit Buttons, the default value is zero.

Title
Object Object Object

Opcional.Optional. Expresión de tipo String que se muestra en la barra de título del cuadro de diálogo.String expression displayed in the title bar of the dialog box. Si se omite Title, aparece el nombre de la aplicación en la barra de título.If you omit Title, the application name is placed in the title bar.

Devoluciones

ConstanteConstant ValorValue
OK 11
Cancel 22
Abort 33
Retry 44
Ignore 55
Yes 66
No 77
..

Excepciones

Prompt no es una expresión String o Title no es válido.Prompt is not a String expression, or Title is invalid.

El proceso no se está ejecutando en modo interactivo de usuario.Process is not running in User Interactive mode.

Uno o más parámetros no son miembros de la enumeración MsgBoxResult o MsgBoxStyle.One or more parameters not a member of MsgBoxResult or MsgBoxStyle enumeration.

Ejemplos

En este ejemplo se usa la función MsgBox para mostrar un mensaje de error crítico en un cuadro de diálogo con los botones sí y no.This example uses the MsgBox function to display a critical-error message in a dialog box with Yes and No buttons. El botón no se especifica como respuesta predeterminada.The No button is specified as the default response. Para ello, se combinan los valores constantes de MsgBox en una expresión numérica.This is done by combining the MsgBox constant values into one numeric expression. En este caso, agregar 4 (la combinación de botones sí/no) y 16 (la ventana de mensajes críticos ) y 256 (el segundo botón como botón predeterminado) proporciona un total de 276.In this case, adding 4 (the Yes/No button combination) and 16 (the Critical Message window) and 256 (the second button as default button) gives a total of 276. El valor devuelto por la función MsgBox depende del botón elegido por el usuario: Sí devuelve un valor de 6; No devuelve un valor de 7.The value returned by the MsgBox function depends on the button chosen by the user: Yes returns a value of 6; No returns a value of 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

Comentarios

Si omite los argumentos posicionales, debe conservar el delimitador de coma correspondiente.If you omit any positional arguments, you must retain the corresponding comma delimiter.

Si el cuadro de diálogo muestra un botón Cancelar , presionar la tecla ESC tiene el mismo efecto que hacer clic en Cancelar .If the dialog box displays a Cancel button, pressing the ESC key has the same effect as clicking Cancel

Si el cuadro de diálogo contiene un botón ayuda , se proporciona ayuda contextual para el cuadro de diálogo.If the dialog box contains a Help button, context-sensitive Help is provided for the dialog box. Sin embargo, no se devuelve ningún valor hasta que se elige uno de los otros botones.However, no value is returned until one of the other buttons is chosen. En aplicaciones de Windows Forms, al elegir el botón ayuda se ejecuta el evento HelpRequested para el formulario.In Windows Form applications, choosing the Help button executes the HelpRequested event for the form.

Nota

La función MsgBox requiere UIPermission en el nivel @no__t 2, lo que puede afectar a su ejecución en situaciones de confianza parcial.The MsgBox function requires UIPermission at the SafeTopLevelWindows level, which may affect its execution in partial-trust situations. Para obtener más información, vea UIPermission.For more information, see UIPermission.

En la tabla siguiente se enumeran los valores de enumeración MsgBoxStyle.The MsgBoxStyle enumeration values are listed in the following table.

MiembroMember ValorValue DescripciónDescription
MiembroMember ValorValue DescripciónDescription
OKOnly 00 Solo muestra el botón Aceptar.Displays OK button only.
OKCancel 11 Muestra los botones aceptar y cancelar.Displays OK and Cancel buttons.
AbortRetryIgnore 22 Muestra los botones anular, reintentar y omitir.Displays Abort, Retry, and Ignore buttons.
YesNoCancel 33 Muestra los botones sí, no y cancelar.Displays Yes, No, and Cancel buttons.
YesNo 44 Muestra los botones sí y no.Displays Yes and No buttons.
RetryCancel 55 Muestra los botones reintentar y cancelar.Displays Retry and Cancel buttons.
Critical 1616 Muestra el icono de mensaje crítico.Displays Critical Message icon.
Question 3232 Muestra el icono de consulta de advertencia.Displays Warning Query icon.
Exclamation 4848 Muestra el icono del mensaje de advertencia.Displays Warning Message icon.
Information 6464 Muestra el icono de mensaje de información.Displays Information Message icon.
DefaultButton1 00 El primer botón es el predeterminado.First button is default.
DefaultButton2 256256 El segundo botón es el predeterminado.Second button is default.
DefaultButton3 512512 El tercer botón es el predeterminado.Third button is default.
ApplicationModal 00 La aplicación es modal.Application is modal. El usuario debe responder al cuadro de mensaje antes de continuar trabajando en la aplicación actual.The user must respond to the message box before continuing work in the current application.
SystemModal 40964096 El sistema es modal.System is modal. Todas las aplicaciones se suspenden hasta que el usuario responde al cuadro de mensaje.All applications are suspended until the user responds to the message box.
MsgBoxSetForeground 6553665536 Especifica la ventana de cuadro de mensaje como ventana de primer plano.Specifies the message box window as the foreground window.
MsgBoxRight 524288524288 El texto está alineado a la derecha.Text is right-aligned.
MsgBoxRtlReading 10485761048576 Especifica que el texto debe aparecer como lectura de derecha a izquierda en los sistemas hebreo y árabe.Specifies text should appear as right-to-left reading on Hebrew and Arabic systems.

El primer grupo de valores (0-5) describe el número y el tipo de botones que se muestran en el cuadro de diálogo.The first group of values (0-5) describes the number and type of buttons displayed in the dialog box. El segundo grupo (16, 32, 48, 64) describe el estilo de icono.The second group (16, 32, 48, 64) describes the icon style. El tercer grupo (0, 256, 512) determina qué botón es el predeterminado.The third group (0, 256, 512) determines which button is the default. El cuarto grupo (0, 4096) determina la modalidad del cuadro de mensaje y el quinto grupo especifica si la ventana de cuadro de mensaje es la ventana de primer plano, junto con la alineación y la dirección del texto.The fourth group (0, 4096) determines the modality of the message box, and the fifth group specifies whether or not the message box window is the foreground window, along with the alignment and direction of the text. Al agregar números para crear un valor final para el argumento Buttons, use solo un número de cada grupo.When adding numbers to create a final value for the Buttons argument, use only one number from each group.

Se aplica a

Consulte también: