MESSAGEBOX ( ) (Funcin)

Visual Studio 6.0 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)) eneMessageText para 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 Especifica 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","MyTitle",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 = WAIT WINDOW CASE nAnswer = WAIT WINDOW ENDCASE

6 'You chose Yes' 7 'You chose No'