Compartir a través de

Función MessageBoxIndirectA (winuser.h)

  • Artículo

Crea, muestra y opera un cuadro de mensaje. El cuadro de mensaje contiene texto y título del mensaje definido por la aplicación, cualquier icono y cualquier combinación de botones de inserción predefinidos.

Sintaxis

int MessageBoxIndirectA(
  [in] const MSGBOXPARAMSA *lpmbp
);

Parámetros

[in] lpmbp

Tipo: const LPMSGBOXPARAMS

Puntero a un MSGBOXPARAMS estructura que contiene información utilizada para mostrar el cuadro de mensaje.

Valor devuelto

Tipo: int

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

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, presionar ESC no tiene ningún efecto.

Si no hay suficiente memoria para crear el cuadro de mensaje, el valor devuelto es cero.

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 lpszText y lpszCaption miembros del MSGBOXPARAMS estructura no se deben tomar de un archivo de recursos, ya que un intento de cargar el recurso puede producir un error.

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 MessageBoxIndirect 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
conjunto de API de ext-ms-win-ntuser-dialogbox-l1-1-0 (introducido en Windows 8)

Consulte también

conceptual de

cuadros de diálogo

MSGBOXPARAMS de

cuadro de mensajes

MessageBoxEx de

de referencia de