Estrutura MSGBOXPARAMSA (winuser.h)
Contém informações usadas para exibir uma caixa de mensagem. A função
Sintaxe
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;
Membros
cbSize
Tipo: UINT
O tamanho da estrutura, em bytes.
hwndOwner
Tipo: HWND
Um identificador para a janela do proprietário. Esse membro pode ser NULL.
hInstance
Tipo: HINSTANCE
Um identificador para o módulo que contém o recurso de ícone identificado pelo membro
lpszText
Tipo: LPCTSTR
Uma cadeia de caracteres terminada em nulo ou o identificador de um recurso de cadeia de caracteres que contém a mensagem a ser exibida.
lpszCaption
Tipo: LPCTSTR
Uma cadeia de caracteres terminada em nulo ou o identificador de um recurso de cadeia de caracteres que contém o título da caixa de mensagem. Se esse membro estiver NULL, o título padrão Error será usado.
dwStyle
Tipo: DWORD
O conteúdo e o comportamento da caixa de diálogo. Esse membro pode ser uma combinação de sinalizadores descritos para o parâmetro
Além disso, você pode especificar o sinalizador de MB_USERICON (0x00000080L) se quiser que a caixa de mensagem exiba o ícone especificado pelo membro lpszIcon.
lpszIcon
Tipo: LPCTSTR
Identifica um recurso de ícone. Esse parâmetro pode ser uma cadeia de caracteres terminada em nulo ou um identificador de recurso inteiro passado para a macro
Para carregar um dos ícones padrão definidos pelo sistema, defina o membro hInstance para NULL e defina lpszIcon como um dos valores listados com a função LoadIcon.
Esse membro será ignorado se o membro dwStyle não especificar o sinalizador MB_USERICON.
dwContextHelpId
Tipo: DWORD_PTR
Identifica um contexto de ajuda. Se ocorrer um evento de ajuda, esse valor será especificado na estrutura de HELPINFO
lpfnMsgBoxCallback
Um ponteiro para a função de retorno de chamada que processa eventos de ajuda para a caixa de mensagem. A função de retorno de chamada tem o seguinte formulário:
VOID CALLBACK MsgBoxCallback(LPHELPINFO lpHelpInfo);
Se esse membro estiver NULL, a caixa de mensagem enviará WM_HELP mensagens para a janela do proprietário quando ocorrerem eventos de ajuda.
dwLanguageId
Tipo: DWORD
O idioma no qual exibir o texto contido nos botões de push predefinidos. Esse valor deve estar no formulário retornado pela macro
Para obter uma lista de identificadores de idioma com suporte, consulte Identificadores de Idioma. Observe que cada versão localizada do Windows normalmente contém recursos apenas para um conjunto limitado de idiomas. Assim, por exemplo, a versão dos EUA oferece LANG_ENGLISH, a versão francesa oferece LANG_FRENCH, a versão alemã oferece LANG_GERMANe a versão japonesa oferece LANG_JAPANESE. Cada versão oferece LANG_NEUTRAL. Isso limita o conjunto de valores que podem ser usados com o parâmetro dwLanguageId. Antes de especificar um identificador de idioma, você deve enumerar as localidades instaladas em um sistema.
Observações
Nota
O cabeçalho winuser.h define MSGBOXPARAMS como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
| cabeçalho | winuser.h (inclua Windows.h) |
Consulte também
Conceitual
loadicon
outros recursos
de referência de