MessageBoxIndirect

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);
 

Parâmetros

lpMsgBoxParams
Ponteiro para uma estrutura MSGBOXPARAMS que contém informações usadas para exibir a caixa de mensagem.

Retornar valores

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.

Observações

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.

QuickInfo

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.

Ver também

Visão geral de caixas de diálogo, funções de caixa de diálogo, MessageBox, MessageBoxEx, MSGBOXPARAMS

Index