Função MessageBoxExA (winuser.h)

Artigo
03/13/2024

Cria, exibe e opera uma caixa de mensagem. A caixa de mensagem contém uma mensagem e um título definidos pelo aplicativo, além de qualquer combinação de ícones predefinidos e botões de push. Os botões estão no idioma da interface do usuário do sistema.

Atualmente , MessageBoxEx e MessageBox funcionam da mesma maneira.

Sintaxe

int MessageBoxExA(
  [in, optional] HWND   hWnd,
  [in, optional] LPCSTR lpText,
  [in, optional] LPCSTR lpCaption,
  [in]           UINT   uType,
  [in]           WORD   wLanguageId
);

Parâmetros

[in, optional] hWnd

Digite: HWND

Um identificador para a janela do proprietário da caixa de mensagem a ser criada. Se esse parâmetro for NULL, a caixa de mensagem não terá nenhuma janela de proprietário.

[in, optional] lpText

Tipo: LPCTSTR

A mensagem a ser exibida.

[in, optional] lpCaption

Tipo: LPCTSTR

O título da caixa de diálogo. Se esse parâmetro for NULL, o título padrão Error será usado.

[in] uType

Tipo: UINT

O conteúdo e o comportamento da caixa de diálogo. Para obter informações sobre os sinalizadores com suporte, consulte MessageBox.

[in] wLanguageId

Tipo: WORD

O idioma do texto exibido nos botões da caixa de mensagem. Especificar um valor zero (0) indica a exibição do texto do botão no idioma padrão do sistema. Se esse parâmetro for MAKELANGID(LANG_NEUTRAL, SUBLANG_NEUTRAL), o idioma atual associado ao thread de chamada será usado.

Para especificar um idioma diferente do idioma atual, use a macro MAKELANGID para criar esse parâmetro. Para obter mais informações, consulte MAKELANGID.

Retornar valor

Tipo: int

Se uma caixa de mensagem tiver um botão Cancelar , a função retornará o valor IDCANCEL se a tecla ESC for pressionada ou o botão Cancelar estiver selecionado. Se a caixa de mensagem não tiver nenhum botão Cancelar , pressionar ESC não terá efeito , a menos que um botão MB_OK esteja presente. Se um botão MB_OK for exibido e o usuário pressionar ESC, o valor retornado será IDOK.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Se a função for bem-sucedida, o valor retornado será um dos seguintes valores de item de menu.

Valor/código retornado	Descrição
IDABORT 3	O botão Anular foi selecionado.
IDCANCEL 2	O botão Cancelar foi selecionado.
IDCONTINUE 11	O botão Continuar foi selecionado.
IDIGNORE 5	O botão Ignorar foi selecionado.
IDNO 7	O botão Não foi selecionado.
IDOK 1	O botão OK foi selecionado.
IDRETRY 4	O botão Repetir foi selecionado.
IDTRYAGAIN 10	O botão Tentar Novamente foi selecionado.
IDYES 6	O botão Sim foi selecionado.

Comentários

Quando você usa uma caixa de mensagem modal do sistema para indicar que o sistema está com pouca memória, as cadeias de caracteres apontadas pelos parâmetros lpText e lpCaption não devem ser retiradas de um arquivo de recurso porque uma tentativa de carregar o recurso pode falhar.

Se você criar uma caixa de mensagem enquanto uma caixa de diálogo estiver presente, use um identificador para a caixa de diálogo como o parâmetro hWnd . O parâmetro hWnd não deve identificar uma janela filho, como um controle em uma caixa de diálogo.

Observação

O cabeçalho winuser.h define MessageBoxEx 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]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll