Función MessageBoxExA (winuser.h)

Artículo
03/04/2024

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

Mensaje que se va a mostrar.

[in, optional] lpCaption

Tipo: LPCTSTR

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 MessageBox.

[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 valor IDCANCEL si se presiona la tecla ESC o se selecciona el botón Cancelar . Si el cuadro de mensaje no tiene ningún botón Cancelar , presionar ESC no tendrá ningún efecto, a menos que haya un botón MB_OK presente. Si se muestra un botón de MB_OK y el usuario presiona ESC, el valor devuelto será IDOK.

Si la función no se realiza correctamente, 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 o valor devuelto	Descripción
IDABORT 3	Se ha seleccionado el botón Anular .
IDCANCEL 2	Se ha seleccionado el botón Cancelar .
IDCONTINUE 11	Se ha seleccionado el botón Continuar .
IDIGNORE 5	Se ha seleccionado el botón Omitir .
IDNO 7	Se ha seleccionado el botón No .
IDOK 1	Se ha seleccionado el botón Aceptar .
IDRETRY 4	Se ha seleccionado el botón Reintentar .
IDTRYAGAIN 10	Se ha seleccionado el botón Probar de nuevo .
IDYES 6	Se ha seleccionado el botón Sí .

Comentarios

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

Si crea un cuadro de mensaje mientras un cuadro de diálogo está presente, 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 Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll