Estructura MSGBOXPARAMSA (winuser.h)
Contiene información utilizada para mostrar un cuadro de mensaje. La función
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 lpszText o lpszCaption.
lpszText
Tipo: LPCTSTR de
Cadena terminada en NULL o el identificador de un recurso de cadena que contiene el mensaje que se va a mostrar.
lpszCaption
Tipo: LPCTSTR de
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 de
Contenido y comportamiento del cuadro de diálogo. Este miembro puede ser una combinación de marcas descritas para el parámetro
Además, puede especificar la marca MB_USERICON (0x00000080L) si desea que el cuadro de mensaje muestre el icono especificado por el miembro lpszIcon.
lpszIcon
Tipo: LPCTSTR de
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 el HELPINFO estructura 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 de
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 de
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_GERMANy 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
Observaciones
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 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] |
| encabezado de |
winuser.h (incluya Windows.h) |
Consulte también
conceptual de
MessageBoxEx de
otros recursos
de referencia de