MessageBox

La función MessageBox crea, muestra y ejecuta un cuadro de mensaje. El cuadro de mensaje contiene un mensaje definido por la aplicación y un título, y además cualquier combinación de iconos predefinidos y botones.

Sintaxis

int MessageBox(
    HWND hWnd,          // manipulador de la ventana propietaria
    LPCTSTR lpText,     // dirección del texto del mensaje
    LPCTSTR lpCaption,  // dirección del texto del título
    UINT uType          // estilo del cuadro de mensaje
   );

Parámetros:

hWnd: identifica a la ventana propietaria del cuadro de mensaje a crear. Si este parámetro es NULL, el cuadro de mensaje no tendrá ventana propietaria.

lpText: apunta a una cadena terminada en cero que contiene el mensaje a mostrar.

lpCaption: apunta a una cadena terminada en cero usada como título para el cuadro de diálogo. Si este parámetro es NULL, se usará el título por defecto de Error.

uType: especifica el contenido y comportamiento del cuadro de diálogo. Este parámetro puede ser una combinación de los siguientes valores:

Valor de retorno

El valor de retorno es cero si no ha suficiente memoria para crear el cuadro de mensaje.

Si la función tiene éxito, el valor de retorno es uno de los siguientes valores de ítem de menú devueltos por el cuadro de diálogo:

Si un cuadro de mensaje contiene un botón de Cancelar, la función devuelve el valor IDCANCEL tanto si se pulsa la tecla ESC como si se pulsa el botón de Cancelar. Si el cuadro de mensaje no tiene el botón de Cancelar, presionar ESC no tiene efecto.

Observaciones

Cuando uses un cuadro de mensaje de tipo para indicar que el sistema está bajo de memoria, las cadenas apuntadas por los parámetros lpText y lpCaption no deben ser tomados desde un fichero de recursos, porque un intento de cargar un recurso podría fallar.

Cuando una aplicación llama a MessageBox y especifica los flags MB_ICONHAND y MB_SYSTEMMODAL para el parámetro uType, Windows muestra el cuadro de mensaje resultante independientemente de la memoria disponible. Cuando esos flags son especificados, Windows limita la longitud del texto del mensaje a tres líneas. Windows no rompe automáticamente las líneas para que quepan en el cuadro de mensaje, así que la cadena del mensaje debe contener retornos de línea para separar las líneas en los lugares apropiados.

Si creas un cuadro de mensaje mientras un cuadro de diálogo está abierto, usa el manipulador del cuadro de diálogo como parámetro para hWnd. El parámetro hWnd no debe identificar a una ventana hija como por ejemplo un control de un cuadro de diálogo.

Sólo en Windows 95: el sistema puede soportar un máximo de 16,364 manipuladores de ventana.