MESSAGEBOX( ) (Funcin)

Muestra un cuadro de dilogo definido por el usuario.

Sintaxis
MESSAGEBOX(cTextoMensaje [, nTipoCuadroDilogo [, cTextoBarraTtulo]])
Tipos devueltos
Numeric
Argumentos
cTextoMensaje
Especifica el texto que aparece en el cuadro de dilogo. Utilice un retorno de carro (CHR(13)) en
cTextoMensaje para mover una parte del mensaje a la siguiente lnea del cuadro de dilogo. El
alto y el ancho del cuadro de dilogo aumentan lo que sea necesario para que quepa
cTextoMensaje.
nTipoCuadroDilogo
Especifica los botones y los iconos que aparecen en el cuadro de dilogo, el botn elegido
inicialmente cuando se muestra y el comportamiento del mismo.
En las tablas siguientes, los valores 0 a 5 del botn del cuadro de dilogo especifican los
botones que aparecen en el mismo. Los valores de icono 16, 32, 48 y 64 especifican el icono que
aparece en el cuadro de dilogo. Los valores predeterminados 0, 256 y 512 especifican qu
botn del cuadro de dilogo es el botn predeterminado. El botn predeterminado se selecciona
cuando aparece el cuadro de dilogo.
Omitir nTipoCuadroDilogo es lo mismo que especificar un valor de 0 para nTipoCuadroDilogo.
Valor

Botones del cuadro de dilogo

Slo botn Aceptar.

Valor Icono

Botones Aceptar y Cancelar.

16

Punto.

Botones Anular, Reintentar e

Ignorar.

32

Signo de interrogacin.

48

Signo de exclamacin.

Botones S, No y Cancelar.

64

Icono de informacin (i).

Botones S y No.

Botones Reintentar y Cancelar.

Valor Botn
predeterminado
0

Primer botn.

256

Segundo botn.

512

Tercer botn.

nTipoCuadroDilogo puede ser la suma de hasta tres valores, uno de cada una de las tablas
anteriores. Por ejemplo, si nTipoCuadroDilogo es 290 (2+32+256), el cuadro de dilogo
especificado tendr las siguientes caractersticas:
Botones Anular, Reintentar e Ignorar.
El cuadro de mensaje muestra el icono del signo de interrogacin.
El segundo botn, Reintentar, es el botn predeterminado.
cTextoBarraTtulo
Especifica el texto que aparece en la barra de ttulo del cuadro de dilogo. Si omite
cTextoBarraTtulo, en la barra de ttulo aparecer el ttulo "Microsoft Visual FoxPro".

Comentarios
El valor que devuelve MESSAGEBOX( ) indica qu botn del cuadro de dilogo se ha elegido. En
los cuadros de dilogo con un botn Cancelar, al presionar la tecla ESC para salir del cuadro de
dilogo se devolver el mismo valor (2) que al elegir Cancelar.
Observe que la abreviatura ms corta para esta funcin es MESSAGEB( ).
La tabla siguiente muestra los valores que devuelve MESSAGEBOX( ) para cada botn.
Valor
devuelto

Botn

Aceptar

Cancelar

Anular

Reintentar

Ignorar

No