Compartilhar via


Estrutura MSGBOXPARAMSW (winuser.h)

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

Sintaxe

typedef struct tagMSGBOXPARAMSW {
  UINT           cbSize;
  HWND           hwndOwner;
  HINSTANCE      hInstance;
  LPCWSTR        lpszText;
  LPCWSTR        lpszCaption;
  DWORD          dwStyle;
  LPCWSTR        lpszIcon;
  DWORD_PTR      dwContextHelpId;
  MSGBOXCALLBACK lpfnMsgBoxCallback;
  DWORD          dwLanguageId;
} MSGBOXPARAMSW, *PMSGBOXPARAMSW, *LPMSGBOXPARAMSW;

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

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 MAKEINTRESOURCE.

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 que a caixa de mensagem envia à janela do proprietário ou à 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 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 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_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

Caixas de diálogo

HELPINFO

loadicon

MAKEINTRESOURCE

MAKELANGID

MessageBoxEx

MessageBoxIndirect

outros recursos

de referência de

WM_HELP