AfxMessageBox

intAfxMessageBox (LPCTSTRlpszText,UINTnTypeMB_OK,UINTnIDHelp=0=);

intAFXAPIAfxMessageBox (UINTnIDPrompt,UINTnTypeMB_OK,UINTnIDHelp=(UINT)-1=);

Valor de retorno

Zero se não houver memória suficiente para exibir a caixa de mensagem; caso contrário, um dos seguintes valores é retornado:

• IDABORT   Anular botão foi selecionado.
  
  
• IDCA&NCELnbsp;  O botão Cancelar foi selecionado.
  
  
• IDIG&NOREnbsp;  Ignorar botão foi selecionado.
  
  
• ID&NOnbsp;  O botão não foi selecionado.
  
  
• IDOK   O botão OK foi selecionado.
  
  
• IDRETRY   Repetir botão foi selecionado.
  
  
• IDYES   Sim botão foi selecionado.

Se uma caixa de mensagem tem um botão Cancelar, o valor IDCANCEL será retornado se a tecla ESC é pressionada ou o botão Cancelar é selecionado. Se a caixa de mensagem com nenhum botão Cancelar, pressionando a tecla ESC tem nenhum efeito.

As funções AfxFormatString1 e AfxFormatString2 podem ser útil para formatação de texto que aparece em uma caixa de mensagem.

Parâmetros

lpszText

Aponta para um objeto CString ou Cadeia de caracteres terminada por caractere nulo que contém a mensagem a ser exibida na caixa de mensagem.

nType

O estilo da caixa de me&nsagem. Aplicar qualquer um dos estilos de caixa de mensagem para o box.nbsp;

nIDHelp

A ID de contexto da ajuda para a mensagem; 0 indica o que contexto de ajuda do aplicativo padrão será usado.

nIDPrompt

Um ID exclusivo usado para fazer referência a uma Cadeia de caracteres na tabela de Cadeia de caracteres.

Observações

Exibe uma caixa de mensagem na tela. O primeiro formulário desta função sobrecarregada exibe uma Cadeia de caracteres de texto apontada pelo lpszText na caixa de mensagem e usa nIDHelp para descrever um contexto da ajuda. O contexto de ajuda é usado para saltar para um tópico da ajuda associado quando o usuário pressiona a tecla de ajuda (normalmente F1).

A segu&nda forma da função usa o recurso de Cadeia de caracteres com o ID nIDPrompt para exibir uma mensagem na caixa de mensagem. A página de ajuda associada é encontrada e o valor de nIDHelp. Se é usado o valor padrão nIDHelp (– 1), a identificação de recurso de Cadeia de caracteres, nIDPrompt, é usada para o contexto da ajuda. Para obter mais informações sobre a definição de contextos de ajuda, consulte o artigo Tópicos de ajuda no Guia do programador do Visual C++ e técnicas nota 28.nbsp;

Co&nsulte tambémnbsp;CWnd::MessageBox