Estructura MSGBOXPARAMSA (winuser.h)

Artículo
03/15/2023

Contiene información utilizada para mostrar un cuadro de mensaje. La función MessageBoxIndirect usa esta estructura.

Sintaxis

typedef struct tagMSGBOXPARAMSA {
  UINT           cbSize;
  HWND           hwndOwner;
  HINSTANCE      hInstance;
  LPCSTR         lpszText;
  LPCSTR         lpszCaption;
  DWORD          dwStyle;
  LPCSTR         lpszIcon;
  DWORD_PTR      dwContextHelpId;
  MSGBOXCALLBACK lpfnMsgBoxCallback;
  DWORD          dwLanguageId;
} MSGBOXPARAMSA, *PMSGBOXPARAMSA, *LPMSGBOXPARAMSA;

Miembros

cbSize

Tipo: UINT

Tamaño de la estructura, en bytes.

hwndOwner

Tipo: HWND

Identificador de la ventana del propietario. Este miembro puede ser NULL.

hInstance

Tipo: HINSTANCE

Identificador del módulo que contiene el recurso de icono identificado por el miembro lpszIcon y el recurso de cadena identificado por el miembro lpszText o lpszCaption .

lpszText

Tipo: LPCTSTR

Cadena terminada en null o el identificador de un recurso de cadena que contiene el mensaje que se va a mostrar.

lpszCaption

Tipo: LPCTSTR

Cadena terminada en null o el identificador de un recurso de cadena que contiene el título del cuadro de mensaje. Si este miembro es NULL, se usa el título predeterminado Error .

dwStyle

Tipo: DWORD

El contenido y el comportamiento del cuadro de diálogo. Este miembro puede ser una combinación de marcas descritas para el parámetro uType de la función MessageBoxEx .

Además, puede especificar la marca MB_USERICON (0x000000080L) si desea que el cuadro de mensaje muestre el icono especificado por el miembro lpszIcon .

lpszIcon

Tipo: LPCTSTR

Identifica un recurso de icono. Este parámetro puede ser una cadena terminada en null o un identificador de recurso entero pasado a la macro MAKEINTRESOURCE .

Para cargar uno de los iconos estándar definidos por el sistema, establezca el miembro hInstance en NULL y establezca lpszIcon en uno de los valores enumerados con la función LoadIcon .

Este miembro se omite si el miembro dwStyle no especifica la marca MB_USERICON .

dwContextHelpId

Tipo: DWORD_PTR

Identifica un contexto de ayuda. Si se produce un evento de ayuda, este valor se especifica en la estructura HELPINFO que el cuadro de mensaje envía a la ventana del propietario o a la función de devolución de llamada.

lpfnMsgBoxCallback

Tipo: MSGBOXCALLBACK

Puntero a la función de devolución de llamada que procesa eventos de ayuda para el cuadro de mensaje. La función de devolución de llamada tiene el siguiente formato:

VOID CALLBACK MsgBoxCallback(LPHELPINFO lpHelpInfo);

Si este miembro es NULL, el cuadro de mensaje envía WM_HELP mensajes a la ventana del propietario cuando se producen eventos de ayuda.

dwLanguageId

Tipo: DWORD

Idioma en el que se va a mostrar el texto contenido en los botones de inserción predefinidos. Este valor debe estar en el formulario devuelto por la macro MAKELANGID .

Para obtener una lista de los identificadores de idioma admitidos, consulte Identificadores de idioma. Tenga en cuenta que cada versión localizada de Windows normalmente contiene recursos solo para un conjunto limitado de idiomas. Por ejemplo, la versión estadounidense ofrece LANG_ENGLISH, la versión francesa ofrece LANG_FRENCH, la versión alemana ofrece LANG_GERMAN y la versión japonesa ofrece LANG_JAPANESE. Cada versión ofrece LANG_NEUTRAL. Esto limita el conjunto de valores que se pueden usar con el parámetro dwLanguageId . Antes de especificar un identificador de idioma, debe enumerar las configuraciones regionales instaladas en un sistema.

Comentarios

Nota

El encabezado winuser.h define MSGBOXPARAMS 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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]
Encabezado	winuser.h (incluya Windows.h)