MessageBox

9/9/2008

Essa função cria, exibe e opera uma caixa mensagem. Caixa de mensagem contém uma mensagem Application-defined e título, mais qualquer combinação de predefinidos Ícones e botões enviar.

Syntax

int MessageBox(
  HWND hWnd, 
  LPCTSTR lpText, 
  LPCTSTR lpCaption, 
  UINT uType
); 

Parameters

• hWnd
  [no] Identificador para o janela proprietária da caixa de mensagem a ser criado. Se este parâmetro é NULL, caixa de mensagem tem não janela proprietária.

• lpText
  [no] Ponteiro longo para um seqüência de caracteres NULL-Terminated que contém a mensagem a ser exibido.

• lpCaption
  [no] Ponteiro longo para um seqüência de caracteres NULL-Terminated usado para o título caixa de diálogo. Se este parâmetro é NULL, o título usar como padrão Erro é usado.

• uType
  [no] Especifica um conjunto de sinalizadores bit que determinam o conteúdo e comportamento da caixa de diálogo. Este parâmetro pode ser uma combinação de sinalizadores do seguinte Grupos de sinalizadores.

  Especifique uma do seguinte sinalizadores para indicar os botões contidos em caixa de mensagem.

  Valor	Descrição
  MB_ABORTRETRYIGNORE	Caixa de mensagem contém três botões enviar: Anular, Repetir, e Ignorar.
  MB_OK	Caixa de mensagem contém um botão de ação: OK. Essa é a usar como padrão.
  MB_OKCANCEL	Caixa de mensagem contém dois botões enviar: OK e Cancelar.
  MB_RETRYCANCEL	Caixa de mensagem contém dois botões enviar: Repetir e Cancelar.
  MB_YESNO	Caixa de mensagem contém dois botões enviar: Sim e Não.
  MB_YESNOCANCEL	Caixa de mensagem contém três botões enviar: Sim, Não, e Cancelar.

  Especifique uma do seguinte sinalizadores para exibir um ícone na caixa de mensagem.

  Valor	Descrição
  MB_ICONEXCLAMATION, MB_ICONWARNING	Um exclamação-apontar ícone aparece na caixa de mensagem.
  MB_ICONINFORMATION, MB_ICONASTERISK	Um ícone consistindo de uma letra minúscula i Em um círculo aparece na caixa de mensagem.
  MB_ICONQUESTION	Uma pergunta-ícone marca aparece na caixa de mensagem.
  MB_ICONSTOP, MB_ICONERROR, MB_ICONHAND	Um parar-assinar ícone aparece na caixa de mensagem.

  Especifique uma do seguinte sinalizadores para indicar o botão usar como padrão.

  Valor	Descrição
  MB_DEFBUTTON1	O primeiro botão é o botão usar como padrão. MB_DEFBUTTON1 será o usar como padrão a menos que MB_DEFBUTTON2, MB_DEFBUTTON3 ou MB_DEFBUTTON4 é especificado.
  MB_DEFBUTTON2	O segundo botão é o botão usar como padrão.
  MB_DEFBUTTON3	O terceiro botão é o botão usar como padrão.
  MB_DEFBUTTON4	O quarto botão é o botão usar como padrão.

  O seguinte sinalizador é a modalidade usar como padrão da caixa de diálogo.

  Valor

  Descrição

  MB_APPLMODAL

  O usuário deve responder a caixa de mensagem antes de continuar trabalho na janela identificada pelo hWnd parâmetro. No entanto, o usuário pode mover as janelas outros segmentos de trabalho nessas janelas. Depending on a hierarquia das janelas no aplicativo, o usuário talvez possa mover a outras janelas dentro de segmento. Todas as janelas filho do pai da caixa de mensagem são automaticamente desativados, mas janelas popup não são.

  Além disso, você pode especificar o seguinte sinalizadores.

  Valor	Descrição
  MB_SETFOREGROUND	Caixa de mensagem torna-se a janela primeiro plano. Internamente, chamadas do sistema a SetForegroundWindow função de caixa de mensagem.
  MB_TOPMOST	Caixa de mensagem é criada com o estilo janela WS_EX_TOPMOST.
  MB_RTLREADING	Caixa de mensagem exibirá mensagem e texto de legenda Usar ordem de leitura right-to-left em sistemas hebraico e árabe.

Return Value

Zero indica que não há memória suficiente criar a caixa mensagem.

Ao sucesso, um dos valores descritos na seguinte tabela é retornada.

Valor	Descrição
IDABORT	Anular botão foi selecionado.
IDCANCEL	Cancelar botão ou a fechar botão sobre o barra de título foi selecionado.
IDIGNORE	Ignorar botão foi selecionado.
IDNO	Não 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 mensagem tiver um Cancelar botão, a função retornará o valor IDCANCEL se ambos a chave Esc for pressionado ou o Cancelar botão é selecionado. Se não tiver a caixa mensagem Cancelar botão, não pressione Esc tem nenhum efeito.

Remarks

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

Requirements

Header	windows.h
Library	Msgbox.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

MessageBeep
SetForegroundWindow
Dialog Boxes Functions