Função MessageBoxExA (winuser.h)
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
Tipo: 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 de Erro 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 exibir o 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 .
Valor de retorno
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 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.
| Código/valor de retorno | Descrição |
|---|---|
|
O botão Anular foi selecionado. |
|
O botão Cancelar foi selecionado. |
|
O botão Continuar foi selecionado. |
|
O botão ignorar |
|
O botão No foi selecionado. |
|
O botão OK foi selecionado. |
|
O botão Repetir foi selecionado. |
|
O botão Tentar Novamente foi selecionado. |
|
O botão Sim foi selecionado. |
Observações
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 pelo lpText e lpCaption parâmetros 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.
Nota
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 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] |
| da Plataforma de Destino |
Windows |
| cabeçalho | winuser.h (inclua Windows.h) |
| biblioteca | User32.lib |
| de DLL |
User32.dll |
Consulte também
Conceitual
outros recursos
de referência de