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

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 qué botón ha clic el usuario.

public static Microsoft.VisualBasic.MsgBoxResult MsgBox(object Prompt, Microsoft.VisualBasic.MsgBoxStyle Buttons = Microsoft.VisualBasic.MsgBoxStyle.ApplicationModal, object Title = default);
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 = Nothing) As MsgBoxResult

Parámetros

Prompt
Object

Required. String expresión que se muestra como mensaje en el cuadro de diálogo. La longitud máxima de es de Prompt aproximadamente 1024 caracteres, en función del ancho de los caracteres usados. 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 carácter de avance de línea (Chr(10)) o una combinación de caracteres de retorno/avance de línea de carro (Chr(13) y Chr(10)) entre cada línea.

Buttons
MsgBoxStyle

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

Title
Object

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

Devoluciones

Uno de los siguientes valores:

ConstanteValue
OK1
Cancel2
Abort3
Retry4
Ignore5
Yes6
No7

Excepciones

Prompt no es una String expresión o Title no es válida.

El proceso no se está ejecutando en modo interactivo de usuario.

Uno o varios parámetros no son miembros de MsgBoxResult o MsgBoxStyle enumeración.

Ejemplos

En este ejemplo se usa 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 respuesta predeterminada. Para ello, se combinan los MsgBox valores constantes en una expresión numérica. En este caso, agregar 4 (la combinación de botones Sí/No) y 16 (la ventana Mensaje crítico ) y 256 (el segundo botón como botón predeterminado) da un total de 276. El valor devuelto por la 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

Comentarios

Si omite cualquier argumento posicional, debe conservar el delimitador de coma correspondiente.

Si el cuadro de diálogo muestra un botón Cancelar, presionar la tecla ESC tiene el mismo efecto que hacer clic en Cancelar.

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

Nota:

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

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

Miembro Value Description
Miembro Value Description
OKOnly 0 Muestra solo el botón Aceptar.
OKCancel 1 Muestra los botones Aceptar y Cancelar.
AbortRetryIgnore 2 Muestra los botones Anular, Reintentar e Omitir.
YesNoCancel 3 Muestra los botones Sí, No y Cancelar.
YesNo 4 Muestra los botones Sí y No.
RetryCancel 5 Muestra los botones Reintentar y Cancelar.
Critical 16 Muestra el icono De mensaje crítico.
Question 32 Muestra el icono Consulta de advertencia.
Exclamation 48 Muestra el icono Mensaje de advertencia.
Information 64 Muestra el icono Mensaje de información.
DefaultButton1 0 El primer botón es el predeterminado.
DefaultButton2 256 El segundo botón es el predeterminado.
DefaultButton3 512 El tercer botón es 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 en primer plano.
MsgBoxRight 524288 Se alinea el texto a la derecha.
MsgBoxRtlReading 1048576 Especifica que el texto debe mostrarse de derecha a izquierda en sistemas en hebreo y árabe.

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. El segundo grupo (16, 32, 48, 64) describe el estilo de icono. El tercer grupo (0, 256, 512) determina qué botón es el valor 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 agregar números para crear un valor final para el Buttons argumento, use solo un número de cada grupo.

Se aplica a

Consulte también