-MESSAGEBOX ( ) (Funcin)

Muestra un cuadro de dilogo definido por el usuario.

MESSAGEBOX (eMessageText [, cTitleBarText] [, nDialogBoxType] [,
nTimeout])
-Valores devueltos
Numeric
Parmetros
eMessageText
Especifica el texto que aparece en el cuadro de dilogo. Utilice un retorno
de carro (CHR (13)) en eMessageTextpara mover una parte del mensaje a
la lnea siguiente del cuadro de dilogo. El alto y el ancho del cuadro de
dilogo aumentan lo que sea necesario para que quepa cMessageText.
Puede utilizar cualquier funcin o tipo de datos vlido de Visual FoxPro
en vez de eMessageText. Si la funcin que utiliza produce un valor que
no sea un carcter, Visual FoxPro utilizar automticamente
TRANSFORM para proporcionar el carcter equivalente, como en el
siguiente ejemplo:
MESSAGEBOX (DATE ())
-nDialogBoxType
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 nDialogBoxType es lo mismo que especificar un valor de 0
para nDialogBoxType.
Valor

Botones del cuadro de dilogo

Slo botn Aceptar.

Botones Aceptar y Cancelar.

Botones Anular, Reintentar e Ignorar.

Botones S, No y Cancelar.

Botones S y No.

Botones Reintentar y Cancelar.

Valor

Icono

16

Punto.

32

Signo de interrogacin.

48

Signo de exclamacin.

64

Icono de informacin (i).

Valor

Botn predeterminado

Primer botn.

256

Segundo botn.

512

Tercer botn.

-nDialogBoxType puede ser la suma de hasta tres valores, uno de cada

una de las tablas anteriores. Por ejemplo, si nDialogBoxType 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.

Hay disponible informacin adicional acerca de las constantes en el
archivo FoxPro.h, que se encuentra en el directorio de inicio de Visual
FoxPro.
El
uso
de
constantes
definidas
tales
como
MB_ABORTRETRYIGNORE + MB_ICONQUESTION + MB_DEFBUTTON2
puede ser ms legible que 2 + 32 + 256.
cTitleBarText
Especifica el texto que aparece en la barra de ttulo del cuadro de dilogo.
Si omite cTitleBarText, en la barra de ttulo aparecer el ttulo "Microsoft
Visual FoxPro".
nTimeout
Especfica
el
nmero
de
milisegundos
que
Visual
FoxPro
mostrar cMessageText sin ninguna entrada desde el teclado o
el mouse antes de borrar cMessageText. Es posible especificar cualquier
tiempo de espera vlido. Un valor menor de 1 no agotar el tiempo de
espera hasta que se produzca la entrada del usuario (igual que si no se

utiliza el parmetro nTimeout). Cuando se agote el tiempo de espera,

MESSAGEBOX ( ) devolver 1.
Observaciones
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

La funcin MESSAGEBOX ( ) utiliza parmetros inteligentes donde el tipo

de parmetro dicta qu parmetro se est utilizando. El primer parmetro
es requerido y siempre es cMessageText; sin embargo, el segundo
parmetro, opcional, puede ser nDialogBoxType si el tipo es numrico
o cTitleBarText si el tipo es de caracteres. Siempre se asume el
parmetro nTimeout para el segundo parmetro numrico opcional que
se pasa. Algunos ejemplos vlidos son:
MESSAGEBOX ("HELLO, My Title", 36, 1)
MESSAGEBOX ("HELLO", 36,"MyTitle", 1)
MESSAGEBOX ("HELLO", 36, 1)
MESSAGEBOX ("HELLO", 36, 1,"MyTitle")
Ejemplo
El siguiente ejemplo muestra un cuadro de dilogo definido por el usuario.
Como ttulo del cuadro de dilogo definido por el usuario, se muestra el
mensaje "Record not found. Would you like to search again?", y en la
barra de ttulo se muestra "My application".

El cuadro de dilogo definido por el usuario contiene los botones Yes y No,
y el icono del signo de interrogacin; el segundo botn (No) es la
seleccin predeterminada. Cuando elija uno de los botones, la seleccin
se mostrar en pantalla.
cMessageTitle = 'My Application'
cMessageText = 'Record not found. Would you like to search again?'
nDialogType = 4 + 32 + 256
* 4 = Yes and No buttons
* 32 = Question mark icon
* 256 = Second button is default
nAnswer = MESSAGEBOX (cMessageText, nDialogType, cMessageTitle)
DO CASE
CASE nAnswer = 6
WAIT WINDOW 'You chose Yes'
CASE nAnswer = 7
WAIT WINDOW 'You chose No'
ENDCASE