Compartilhar via


CWnd::MessageBox

Cria e exibe uma janela que contém uma mensagem e uma legenda aplicativo fornecidas, mais uma combinação dos ícones e das teclas predefinidos descritos na lista de Estilos da caixa de mensagem .

int MessageBox(
   LPCTSTR lpszText,
   LPCTSTR lpszCaption = NULL,
   UINT nType = MB_OK 
);

Parâmetros

  • lpszText
    Os pontos a CString objeto ou NULL- finalizaram a cadeia de caracteres que contém a mensagem a ser exibida.

  • lpszCaption
    Os pontos a CString objeto ou NULL- finalizaram a cadeia de caracteres a ser usada para a legenda da caixa de mensagem.Se lpszCaption é NULO, a legenda padrão “error” é usada.

  • nType
    Especifica o conteúdo e o comportamento da caixa de mensagem.

Valor de retorno

Este método utiliza a função de MessageBox conforme definido em Windows SDK.Esse método retorna o resultado de chamar a função.

Comentários

Use a função global AfxMessageBox em vez de essa função de membro para implementar uma caixa de mensagem em seu aplicativo.

O seguinte mostra vários ícones do sistema que podem ser usados em uma caixa de mensagem:

Captura de tela de StopSymbol

MB_ICONHAND, MB_ICONSTOP, e MB_ICONERROR

Tela de QuestionWordBubbleSymbol

MB_ICONQUESTION

Tela de ExclamationSymbol

MB_ICONEXCLAMATION e MB_ICONWARNING

Tela de InformationSymbol

MB_ICONASTERISK e MB_ICONINFORMATION

Exemplo

void CMainFrame::OnDisplayErrorMessage()
{
   // This displays a message box with the title "Error"
   // and the message "Help, Something went wrong."
   // The error icon is displayed in the message box, along with
   // an OK button.
   MessageBox(_T("Help, Something went wrong."), _T("Error"), 
      MB_ICONERROR | MB_OK);
}

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CWnd Class

Gráfico de hierarquia

MessageBox

AfxMessageBox