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

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

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.

Requisitos

Consulte también

Conceptual

Cuadros de diálogo

MAKELANGID

MessageBeep

Cuadro de mensajes

MessageBoxIndirect

Otros recursos

Referencia

SetForegroundWindow