Estrutura MSGBOXPARAMSA (winuser.h)

Artigo
08/28/2023

Contém informações usadas para exibir uma caixa de mensagem. A função MessageBoxIndirect usa essa estrutura.

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

Digite: 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 lpszIcon e o recurso de cadeia de caracteres identificado pelo membro lpszText ou lpszCaption .

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 for 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 uType da função MessageBoxEx .

Além disso, você pode especificar o sinalizador 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 MAKEINTRESOURCE .

Para carregar um dos ícones padrão definidos pelo sistema, defina o membro hInstance como 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 HELPINFO que a caixa de mensagem envia para a janela do proprietário ou a função de retorno de chamada.

lpfnMsgBoxCallback

Tipo: MSGBOXCALLBACK

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 formato:

VOID CALLBACK MsgBoxCallback(LPHELPINFO lpHelpInfo);

Se esse membro for 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 MAKELANGID .

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_GERMAN e 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.

Comentários

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	winuser.h (inclua Windows.h)