Cuadro de mensaje

Muestra un mensaje en un cuadro de diálogo, espera a que el usuario haga clic en un botón y devuelve un valor que indica en qué botón ha hecho clic el usuario.

Estructura

MsgBox(mensaje[, botones][, título][, archivo de ayuda, contexto])

Parámetros

mensaje de solicitud: cadena que se muestra como mensaje en el cuadro de diálogo. La longitud máxima de la línea de comandos es de aproximadamente 1024 caracteres, dependiendo de la anchura de los caracteres utilizados. Si la línea de comando consta de más de una línea, puedes separarlas utilizando un carácter de retorno de carro (Chr(13)), un carácter de salto de línea (Chr(10)) o una combinación de caracteres de retorno de carro y salto de línea (Chr(13) & Chr(10)) entre cada línea.

botones: expresión numérica que representa la suma de los valores que especifican el número y el tipo de botones que se mostrarán, el estilo de icono que se utilizará, el botón predeterminado y la modalidad del cuadro de mensaje. Consulte la sección «Configuración» para ver los valores. Si se omite, el valor predeterminado para los botones es 0.

título: cadena de texto que se muestra en la barra de título del cuadro de diálogo. Si no se indica ningún título, se mostrará el nombre de la aplicación en la barra de título.

helpfile: expresión de cadena que identifica el archivo de ayuda que se utilizará para proporcionar ayuda contextual en el cuadro de diálogo. Si se proporciona el archivo de ayuda, también debe proporcionarse el contexto. No disponible en plataformas de 16 bits.

contexto: expresión numérica que identifica el número de contexto de la Ayuda asignado por el autor de la Ayuda al tema correspondiente. Si se proporciona el contexto, también debe proporcionarse el archivo de ayuda. No disponible en plataformas de 16 bits.

Valores de los parámetros

Los parámetros del argumento «buttons» son:

Descripción del valor constante

vbOKOnly 0 Mostrar solo el botón «Aceptar».

vbOKCancel 1 Mostrar los botones «Aceptar» y «Cancelar».

vbAbortRetryIgnore 2 Mostrar los botones «Abortar», «Reintentar» e «Ignorar».

vbYesNoCancel 3 Mostrar los botones «Sí», «No» y «Cancelar».

vbYesNo 4 Mostrar los botones «Sí» y «No».

vbRetryCancel 5 Mostrar los botones «Reintentar» y «Cancelar».

vbCritical 16: Mostrar el icono de mensaje crítico.

vbPregunta 32: Mostrar el icono de consulta de advertencia.

vbExclamation 48: icono para mostrar un mensaje de advertencia.

vbInformation 64: icono de mensaje de información.

vbDefaultButton1 0 El primer botón es el predeterminado.

vbDefaultButton2 256 El segundo botón es el predeterminado.

vbDefaultButton3 512 El tercer botón es el predeterminado.

vbDefaultButton4 768 El cuarto botón es el predeterminado.

vbApplicationModal 0: ventana modal de la aplicación; el usuario debe responder al cuadro de mensaje antes de continuar trabajando en la aplicación actual.

vbSystemModal 4096: ventana modal del sistema; todas las aplicaciones se suspenden hasta que el usuario responda al cuadro de mensaje.

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 los iconos; el tercer grupo (0, 256, 512, 768) determina qué botón es el predeterminado; y el cuarto grupo (0, 4096) determina la modalidad del cuadro de mensaje. Al sumar los números para obtener el valor final de los botones de argumentos, utiliza solo un número de cada grupo.

Valor devuelto

La función MsgBox tiene los siguientes valores de retorno:

Botón de valor constante

, vbOK 1, OK

vbCancel 2 Cancelar

vbAbort 3 Abortar

vbRetry 4: reintentar

vbIgnore 5 Ignorar

vbSí 6 Sí

vbN.º 7 No

Descripción

Cuando se proporcionan tanto el archivo de ayuda como el contexto, el usuario puede pulsar F1 para ver el tema de ayuda correspondiente al contexto.

Si el cuadro de diálogo muestra un botón «Cancelar», pulsar la tecla ESC tiene el mismo efecto que hacer clic en «Cancelar». Si el cuadro de diálogo contiene un botón de Ayuda, se ofrece ayuda contextual para dicho cuadro de diálogo. Sin embargo, no se devuelve ningún valor hasta que se pulse uno de los otros botones.

Cuando se utiliza la función MsgBox con Microsoft Internet Explorer, el título de cualquier cuadro de diálogo que se muestre siempre incluye «VBScript:» para diferenciarlo de los cuadros de diálogo estándar del sistema.

Ejemplo

En el siguiente ejemplo se utiliza la función MsgBox para mostrar un cuadro de mensaje y devolver un valor que indica qué botón se ha pulsado:

Dim MyVar

MyVar = MsgBox("Hello World!", 65, "Ejemplo de MsgBox") ' MyVar contiene 1 o 2, dependiendo del botón en el que se haga clic. |