Función MessageBoxExA (winuser.h)

Crea, muestra y opera un cuadro de mensaje. El cuadro de mensaje contiene un mensaje y un título definidos por la aplicación, además de cualquier combinación de iconos predefinidos y botones de inserción. Los botones están en el idioma de la interfaz de usuario del sistema.

Actualmente MessageBoxEx y MessageBox funcionan de la misma manera.

Sintaxis

int MessageBoxExA(
  [in, optional] HWND   hWnd,
  [in, optional] LPCSTR lpText,
  [in, optional] LPCSTR lpCaption,
  [in]           UINT   uType,
  [in]           WORD   wLanguageId
);

Parámetros

[in, optional] hWnd

Tipo: HWND

Identificador de la ventana de propietario del cuadro de mensaje que se va a crear. Si este parámetro es NULL, el cuadro de mensaje no tiene ninguna ventana de propietario.

[in, optional] lpText

Tipo: LPCTSTR de

Mensaje que se va a mostrar.

[in, optional] lpCaption

Tipo: LPCTSTR de

Título del cuadro de diálogo. Si este parámetro es NULL, se usa el título predeterminado Error.

[in] uType

Tipo: UINT

Contenido y comportamiento del cuadro de diálogo. Para obtener información sobre las marcas admitidas, vea cuadro de mensajes.

[in] wLanguageId

Tipo: word

Idioma del texto que se muestra en los botones del cuadro de mensaje. Especificar un valor de cero (0) indica que se muestra el texto del botón en el idioma predeterminado del sistema. Si este parámetro es MAKELANGID(LANG_NEUTRAL, SUBLANG_NEUTRAL), se usa el idioma actual asociado al subproceso que realiza la llamada.

Para especificar un idioma distinto del lenguaje actual, use la macro MAKELANGID para crear este parámetro. Para obtener más información, vea MAKELANGID.

Valor devuelto

Tipo: int

Si un cuadro de mensaje tiene un botón Cancelar , la función devuelve el IDCANCEL si se presiona la tecla ESC o se selecciona el botón Cancelar . Si el cuadro de mensaje no tiene botón Cancelar, al presionar ESC no tendrá ningún efecto, a menos que esté presente un botón MB_OK. Si se muestra un botón MB_OK y el usuario presiona ESC, el valor devuelto será IDOK.

Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Si la función se ejecuta correctamente, el valor devuelto es uno de los siguientes valores de elemento de menú.

Código y valor devueltos	Descripción
IDABORT 3	Se seleccionó el botón Anular.
IDCANCEL 2	Se seleccionó el botón Cancelar .
IDCONTINUE 11	Se seleccionó el botón Continuar.
IDIGNORE 5	Se seleccionó el botón Omitir .
IDNO de 7	Se seleccionó el botón No.
IDOK 1	Se seleccionó el botón Aceptar.
IDRETRY 4	Se seleccionó el botón Reintentar.
IDTRYAGAIN 10	Se seleccionó el botón Probar de nuevo.
IDYES 6	Se seleccionó el botón Sí.

Observaciones

Cuando se usa un cuadro de mensaje modal del sistema para indicar que el sistema tiene poca memoria, las cadenas a las que apunta el lpText y los parámetros lpCaption no deben tomarse de un archivo de recursos porque puede producirse un error al intentar cargar el recurso.

Si crea un cuadro de mensaje mientras está presente un cuadro de diálogo, use un identificador para el cuadro de diálogo como parámetro hWnd. El parámetro hWnd no debe identificar una ventana secundaria, como un control en un cuadro de diálogo.

Nota

El encabezado winuser.h define MessageBoxEx como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	winuser.h (incluya Windows.h)
biblioteca de	User32.lib
DLL de	User32.dll

Consulte también

conceptual de

cuadros de diálogo

MAKELANGID

messageBeep de

cuadro de mensajes

MessageBoxIndirect

otros recursos

de referencia de

SetForegroundWindow