En una base de datos de escritorio de Access, la función CuadroMsj muestra un mensaje en un cuadro de diálogo, espera a que el usuario haga clic en un botón y devuelve un entero que indica en qué botón ha hecho clic el usuario.
Sintaxis
MsgBox(prompt [, botones ] [, título ] [, helpfile ] [, contexto ] )
La sintaxis de la función CuadroMsj tiene estos argumentos:
| argumento | Descripción |
|---|---|
| símbolo del sistema | Obligatorio. Expresión de cadena mostrada como mensaje en el cuadro de diálogo. La longitud máxima del mensaje es de aproximadamente 1024 caracteres, según el ancho de los caracteres utilizados. Si el indicador consta de más de una línea, puede separar las líneas mediante un carácter de retorno de carro (13)), un carácter de suministro de línea (10)) o retorno de carro – combinación de caracteres de suministro de línea (Chr(13) & Chr(10)) entre cada línea. |
| botones | Opcional. expresión numérica que es la suma de valores que especifican el número y el tipo de botones para 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 los botones es 0. |
| título | Opcional. Expresión de cadena que se muestra en la barra de título del cuadro de diálogo. Si omite el título, el nombre de la aplicación se coloca en la barra de título. |
| archivo de ayuda | 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 se proporciona helpfile , también debe proporcionarse contexto . |
| contexto | 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 se proporciona contexto , también debe proporcionarse helpfile . |
Configuración
Los botonesde configuración de los argumentos son:
| Constante | Valor | Descripción |
|---|---|---|
| vbOKOnly | 0 | Mostrar solo el botón Aceptar . |
| vbOKCancel | 1 | Mostrar los botones Aceptar y Cancelar . |
| vbAbortRetryIgnore | 2 | Mostrar los botones Anular, 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 mensaje crítico . |
| vbQuestion | 32 | Mostrar el icono Consulta de advertencia . |
| vbExclamation | 48 | Mostrar el icono mensaje de advertencia . |
| vbInformation | 64 | Icono Mostrar 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 predeterminado. |
| vbDefaultButton4 | 768 | El cuarto botón es 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 | 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 está alineado a la derecha |
| vbMsgBoxRtlReading | 1048576 | Especifica que el texto debería aparecer como lectura de derecha a izquierda en los sistemas hebreo y árabe. |
El primer grupo de valores (0-5) describe el número y el tipo de 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 qué botón es el predeterminado; y el cuarto grupo (0, 4096) determina la modalidad del cuadro de mensajes. Al sumar números para crear un valor final para el argumento botones , use solo un número de cada grupo.
Nota
Visual Basic para Aplicaciones especifica estas constantes. Como resultado, los nombres se pueden usar 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 helpfile y contexto , el usuario puede presionar F1 (Windows) o AYUDA (macOS) para ver el tema de ayuda correspondiente al contexto. 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 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 hace clic en 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
Los ejemplos siguientes muestran el uso de esta función en un módulo de Visual Basic para Aplicaciones (VBA).
En este ejemplo se usa la función CuadroMsj 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 función CuadroMsj depende del botón elegido por 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