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 icono que indica qué botón ha seleccionado.
Sintaxis
MsgBox(prompt[, buttons][, title][, helpfile][, context])
La MsgBox sintaxis de las funciones consta de los siguientes 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 separarlas usando 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. |
buttons |
Opcional. 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 usar, la identidad del botón predeterminado y la modalidad del cuadro de mensaje. Si se omite, el valor predeterminado de buttons es 0. |
title |
Opcional. Expresión de cadena mostrada en la barra de título del cuadro de diálogo. Si omite title, el nombre de la aplicación aparecerá en la barra de título. |
helpfile |
Opcional. Expresión de cadena que identifica el archivo de Ayuda que se va a 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, es decir, el número de contexto de Ayuda asignado al tema de Ayuda adecuado por el autor de la Ayuda. Si context se proporciona, helpfile también debe proporcionarse. |
Configuración
Las buttons opciones de configuración del argumento son:
| Constante | Valor | Descripción |
|---|---|---|
vbOKOnly |
0 |
Mostrar solo Correcto . |
vbOKCancel |
1 |
Muestre 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 |
Muestre Reintentar y Cancelar. |
vbCritical |
16 |
Mostrar el icono Mensaje crítico . |
vbQuestion |
32 |
Muestra el icono Consulta de advertencia . |
vbExclamation |
48 |
Mostrar el icono del mensaje de advertencia . |
vbInformation |
64 |
Mostrar el icono del mensaje de información . |
vbDefaultButton1 |
0 |
Haga que el primer botón sea el predeterminado. |
vbDefaultButton2 |
256 |
Haga que el segundo botón sea el predeterminado. |
vbDefaultButton3 |
512 |
Haga 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 responde al cuadro de mensaje. |
vbMsgBoxHelpButton |
16384 |
Agregar un botón de ayuda al cuadro de mensaje. |
VbMsgBoxSetForeground |
65536 |
Especifique la ventana del cuadro de mensaje como ventana en 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 describe05el número y el tipo de botones que aparecen en el cuadro de diálogo. El segundo grupo describe16324864 el estilo del 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 mensaje. 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 parte 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 helpfilecontext , el usuario puede presionar F1 en Windows o la Ayuda en macOS para ver el tema de Ayuda que coincida con context. Algunas aplicaciones host, como Microsoft Excel, también agregan automáticamente un botón de ayuda al cuadro de diálogo.
Si el cuadro de diálogo muestra un botón Cancelar , presionar Esc tiene el mismo efecto que seleccionar Cancelar. Si el cuadro de diálogo contiene un botón de 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 usarlo MsgBox en una expresión. Para omitir algunos argumentos posicionales, debe incluir el delimitador de coma correspondiente.
Ejemplo
Nota
El siguiente ejemplo 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 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