A função MessageBoxIndirect cria, exibe e opera uma caixa de mensagem. A caixa de mensagem contém texto mensagem application-defined e título, qualquer ícone e qualquer combinação de botões predefinidos.
int MessageBoxIndirect ( LPMSGBOXPARAMS lpMsgBoxParams / / endereço da estrutura de mensagem / / caixa parâmetros);
O valor de retorno é zero se não houver memória suficiente para criar a caixa de mensagem.
Se a função for bem-sucedido, o valor de retorno é um dos seguintes valores de item de menu retornados pela caixa de diálogo:
| Valor | Significado |
|---|---|
| IDABORT | Anular botão foi selecionado. |
| IDCANCEL | Cancelar botão foi selecionado. |
| IDIGNORE | Ignorar botão foi selecionado. |
| IDNO | Nenhum botão foi selecionado. |
| IDOK | OK botão foi selecionado. |
| IDRETRY | Repetir botão foi selecionado. |
| IDYES | Sim botão foi selecionado. |
Se uma caixa de mensagem tem um botão Cancelar, a função retornará o valor IDCANCEL se a tecla esc é pressionada ou o botão Cancelar é selecionado. Se a caixa de mensagem com nenhum botão Cancelar, pressionando esc tem nenhum efeito.
Quando você usa uma caixa de mensagem modal de sistema para indicar que o sistema está com pouco memória, as seqüências de caracteres apontado pelo lpszText e lpszCaption Membros da estrutura MSGBOXPARAMS não devem ser tomados de um arquivo de recurso, porque uma tentativa para carregar o recurso pode falhar.
Quando um aplicativo chama MessageBoxIndirect e especifica os sinalizadores MB_ICONHAND e MB_SYSTEMMODAL para o dwStyle membro da estrutura MSGBOXPARAMS , o sistema exibe a caixa de mensagem resultante independentemente da memória disponível. Quando esses sinalizadores são especificados, o sistema limita o ComComprimento do texto da caixa de mensagem em três linhas. O sistema faz não quebrar automaticamente as linhas para caber na caixa de mensagem, no entanto, para que a Cadeia de caracteres de mensagem deve conter retornos para quebrar as linhas nos locais apropriados.
Se você criar uma caixa de mensagem enquanto uma caixa de diálogo estiver presente, use o identificador da caixa de diálogo como o parâmetro de hWnd . O hWnd parâmetro não deve identificar uma janela filho, tais como um controle em uma caixa de diálogo.
Windows 95:O sistema pode oferecer suporte a um máximo de 16.364 identificadores de janela.
nbsp; Windows &NT: requer a versão 4.0 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.
Visão geral de caixas de diálogo, funções de caixa de diálogo, MessageBox, MessageBoxEx, MSGBOXPARAMS