En una base de datos de escritorio de Access, la MsgBox función muestra un mensaje en un cuadro de diálogo, espera a que el usuario seleccione un botón y devuelve un Integer botón que indica qué botón seleccionó el usuario.
Sintaxis
MsgBox(prompt[, buttons][, title][, helpfile][, context])
La MsgBox sintaxis de la función tiene estos argumentos:
| argumento | Descripción |
|---|---|
prompt |
Obligatorio. Expresión de cadena mostrada como mensaje en el cuadro de diálogo. La longitud máxima es de prompt aproximadamente 1024 caracteres, dependiendo del ancho de los caracteres utilizados. Si prompt tiene 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 suministro de línea (Chr(10)) o una combinación de retorno de línea de carro (Chr(13) & Chr(10)) entre cada línea. |
buttons |
Opcional. Expresión numérica que es la suma de valores que especifican el número y el tipo de botones que se muestran, el estilo de icono que se va a usar, la identidad del botón predeterminado y la modalidad del cuadro de mensaje. Si se omite, 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 omite title, el nombre de la aplicación aparece en la barra de título. |
helpfile |
Opcional. Expresión de cadena que identifica el archivo de Ayuda que se usará para proporcionar ayuda contextual para el cuadro de diálogo. Si helpfile se proporciona, context también debe proporcionarse. |
context |
Opcional. Expresión numérica que es el número de contexto de ayuda asignado al tema de Ayuda apropiado por el autor de la Ayuda. Si context se proporciona, helpfile también debe proporcionarse. |
Configuración
La buttons configuración de los argumentos es la siguiente:
| Constante | Valor | Descripción |
|---|---|---|
vbOKOnly |
0 |
Mostrar solo Aceptar . |
vbOKCancel |
1 |
Mostrar Aceptar y Cancelar. |
vbAbortRetryIgnore |
2 |
Mostrar Anular, Reintentar e Ignorar. |
vbYesNoCancel |
3 |
Mostrar Sí, No y Cancelar. |
vbYesNo |
4 |
Mostrar Sí y No. |
vbRetryCancel |
5 |
Mostrar Reintentar y Cancelar. |
vbCritical |
16 |
Mostrar el icono mensaje crítico . |
vbQuestion |
32 |
Mostrar el icono Consulta de advertencia . |
vbExclamation |
48 |
Mostrar el icono Mensaje de advertencia . |
vbInformation |
64 |
Mostrar el icono Mensaje de información . |
vbDefaultButton1 |
0 |
Hacer que el primer botón sea el predeterminado. |
vbDefaultButton2 |
256 |
Hacer que el segundo botón sea el predeterminado. |
vbDefaultButton3 |
512 |
Hacer que el tercer botón sea el predeterminado. |
vbDefaultButton4 |
768 |
Haga que el cuarto botón sea el predeterminado. |
vbApplicationModal |
0 |
Modal de aplicación. El usuario debe responder al cuadro de mensaje antes de continuar trabajando en la aplicación actual. |
vbSystemModal |
4096 |
Modal del sistema. Todas las aplicaciones se suspenden hasta que el usuario responda al cuadro de mensaje. |
vbMsgBoxHelpButton |
16384 |
Agregar un botón ayuda al cuadro de mensaje. |
VbMsgBoxSetForeground |
65536 |
Especifique la ventana del cuadro de mensaje como la ventana de primer plano. |
vbMsgBoxRight |
524288 |
Alinear el texto a la derecha. |
vbMsgBoxRtlReading |
1048576 |
Haga que el texto aparezca con lectura de derecha a izquierda en los sistemas hebreo y árabe. |
El primer grupo de valores (0 a 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 predeterminado. El cuarto grupo (0, 4096) determina la modalidad del cuadro de mensajes. Cuando agregue números para crear un valor final para el buttons argumento, use solo un número de cada grupo.
Nota
Visual Basic para Aplicaciones especifica estas constantes. Como resultado, puede usar los nombres en cualquier lugar del código en lugar de los 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 |
Observaciones
Cuando se proporcionan ambos helpfile y context se proporcionan, el usuario puede presionar F1 en Windows o Ayuda en macOS para ver el tema de ayuda que coincida contextcon . Algunas aplicaciones host, como Microsoft Excel, también agregan automáticamente un botón Ayuda al cuadro de diálogo.
Si en el cuadro de diálogo se muestra el botón Cancelar , al presionar Esc se aplicará lo mismo que si se selecciona 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 el usuario selecciona uno de los otros botones.
Nota
Para especificar más que el primer argumento con nombre, debe usar MsgBox en una expresión. Para omitir algunos argumentos posicionares, debe incluir el delimitador de coma correspondiente.
Ejemplo
Nota
En el ejemplo siguiente se muestra cómo usar esta función en un módulo de Visual Basic para Aplicaciones (VBA).
En este ejemplo se usa la MsgBox función para mostrar un mensaje de error crítico en un cuadro de diálogo con los botones Sí y No . El botón No se especifica como respuesta predeterminada. El valor devuelto por la MsgBox función depende del botón que seleccione el usuario. En este ejemplo se supone que DEMO.HLP es un archivo de Ayuda que contiene un tema con un número de contexto de ayuda igual a 1000.
Dim Msg, Style, Title, Help, Ctxt, Response, MyString
Msg = "Do you want to continue?"
Style = vbYesNo + vbCritical + vbDefaultButton2
Title = "MsgBox Demonstration"
Help = "DEMO.HLP"
Ctxt = 1000
Response = MsgBox(Msg, Style, Title, Help, Ctxt)
If Response = vbYes Then ' User chose Yes.
MyString = "Yes" ' Perform some action.
Else ' User chose No.
MyString = "No" ' Perform some action.
End If