Muestra un mensaje en un cuadro de diálogo, espera a que el usuario haga clic en un botón y devuelve un tipo Integer correspondiente al botón elegido por el usuario.
Sintaxis
MsgBox(prompt[, buttons][, title][,
helpfile, context])
La sintaxis de la función MsgBox consta de estos argumentos con nombre:
|
Parte |
Descripción |
|
prompt |
Requerido. Expresión de cadena que representa el prompt en el cuadro de diálogo. La longitud máxima de prompt es de aproximadamente 1024 caracteres, según el ancho de los caracteres utilizados. Si prompt consta de más de una línea, puede separarlos utilizando un carácter de retorno de carro (Chr(13)) o un carácter de avance de línea (Chr(10)), o una combinación de caracteres de retorno de carro – avance de línea (Chr(13) y Chr(10)) entre cada línea y la siguiente. |
|
buttons |
Opcional. Expresión numérica que corresponde a la suma de los valores que especifican el número y el tipo de los botones que se pretenden mostrar, el estilo de icono que se va a utilizar, la identidad del botón predeterminado y la modalidad del cuadro de mensajes. Si se omite este argumento, el valor predeterminado para buttons es 0. |
|
title |
Opcional. Expresión de cadena que se muestra en la barra de título del cuadro de diálogo. Si se omite title, en la barra de título se coloca el nombre de la aplicación. |
|
helpfile |
Opcional. Expresión de cadena que identifica el archivo de Ayuda que se utiliza para proporcionar ayuda interactiva en el cuadro de diálogo. Si se especifica helpfile, también se debe especificar context. |
|
context |
Opcional. Expresión numérica que es igual al número de contexto de Ayuda asignado por el autor al tema de Ayuda correspondiente. Si se especifica context, también se debe especificar helpfile. |
Valores
El argumento buttons tiene estos valores:
|
Constante |
Valor |
Descripción |
|
VbOKOnly |
0 |
Muestra solamente el botón Aceptar. |
|
VbOKCancel |
1 |
Muestra los botones Aceptar y Cancelar. |
|
VbAbortRetryIgnore |
2 |
Muestra los botones Anular, Reintentar e Ignorar. |
|
VbYesNoCancel |
3 |
Muestra los botones Sí, No y Cancelar. |
|
VbYesNo |
4 |
Muestra los botones Sí y No. |
|
VbRetryCancel |
5 |
Muestra los botones Reintentar y Cancelar. |
|
VbCritical |
16 |
Muestra el icono de mensaje crítico. |
|
VbQuestion |
32 |
Muestra el icono de pregunta de advertencia. |
|
VbExclamation |
48 |
Muestra el icono de mensaje de advertencia. |
|
VbInformation |
64 |
Muestra el 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 |
Aplicación modal; el usuario debe responder al cuadro de mensajes antes de poder seguir trabajando en la aplicación actual. |
|
VbSystemModal |
4096 |
Sistema modal; se suspenden todas las aplicaciones hasta que el usuario responda al cuadro de mensajes. |
|
VbMsgBoxHelpButton |
16384 |
Agrega el botón Ayuda al cuadro de mensaje. |
|
VbMsgBoxSetForeground |
65536 |
Especifica la ventana del cuadro de mensaje como la ventana de primer plano. |
|
VbMsgBoxRight |
524288 |
El texto se alínea a la derecha. |
|
VbMsgBoxRtlReading |
1048576 |
Especifica que el texto debe aparecer para ser leído de derecha a izquierda en sistemas hebreo y árabe. |
El primer grupo de valores (0 a 5) describe el número y el tipo de los botones mostrados en el cuadro de diálogo; el segundo grupo (16, 32, 48, 64) describe el estilo del icono, el tercer grupo (0, 256, 512) determina el botón predeterminado y el cuarto grupo (0, 4096) determina la modalidad del cuadro de mensajes. Cuando se suman números para obtener el valor final del argumento buttons, se utiliza solamente un número de cada grupo.
Nota Estas constantes las especifica Visual Basic for Applications. Por tanto, el nombre de las mismas puede utilizarse en cualquier lugar del código en vez de sus valores reales.
Valores devueltos
|
Constante |
Valor |
Descripción |
|
vbOK |
1 |
Aceptar |
|
vbCancel |
2 |
Cancelar |
|
vbAbort |
3 |
Anular |
|
vbRetry |
4 |
Reintentar |
|
vbIgnore |
5 |
Ignorar |
|
vbYes |
6 |
Sí |
|
vbNo |
7 |
No |
Comentarios
Cuando se proporcionan tanto helpfile como context, el usuario puede presionar F1 para ver el tema de Ayuda correspondiente al context. Algunas aplicaciones host, por ejemplo Microsoft Excel, también agregan automáticamente un botón Ayuda al cuadro de diálogo.
Si el cuadro de diálogo cuenta con un botón Cancelar, presionar la tecla ESC tendrá el mismo efecto que hacer clic en este botón. Si el cuadro de diálogo contiene un botón Ayuda, se suministra ayuda interactiva para ese cuadro de diálogo. Sin embargo, no se devuelve valor alguno hasta que se hace clic en uno de estos botones.
Nota Si desea especificar más que el primer argumento con nombre, debe utilizar MsgBox en una expresión. Si desea omitir algún argumento de posición, debe incluir el delimitador de coma correspondiente.