AfxMessageBox
Exibe uma caixa de mensagem na tela.
int AfxMessageBox(
LPCTSTR lpszText,
UINT nType = MB_OK,
UINT nIDHelp = 0
);
int AFXAPI AfxMessageBox(
UINT nIDPrompt,
UINT nType = MB_OK,
UINT nIDHelp = (UINT
) -1
);
Parâmetros
lpszText
Aponta para um CString o objeto ou seqüência de caracteres terminada com caractere nulo que contém a mensagem a ser exibida na caixa de mensagem.nType
O estilo da caixa de mensagem.Aplicar qualquer o estilos de caixa de mensagem para a caixa.nIDHelp
A ID de contexto de ajuda para a mensagem; 0 indica o contexto de Ajuda do aplicativo padrão será usado.nIDPrompt
Uma ID exclusiva usada para fazer referência a uma seqüência em que a tabela de seqüência de caracteres.
Valor de retorno
Zero se não há memória suficiente para exibir a caixa de mensagem; caso contrário, um dos seguintes valores é retornado:
IDABORT O botão Cancelar foi selecionado.
IDCANCEL O botão Cancelar foi selecionado.
IDIGNORE Botão Ignorar foi selecionado.
IDNO O botão não foi selecionado.
IDOK O botão OK foi selecionado.
IDRETRY Botão Repetir foi selecionado.
IDYES No botão Yes (Sim) foi selecionado.
Se uma caixa de mensagem tiver um botão Cancelar, a IDCANCEL valor será retornado se o tecla ESC é pressionado ou o botão Cancel (Cancelar) está selecionado.Se a caixa de mensagem com nenhum botão Cancelar, pressionando ESC chave não tem efeito.
As funções AfxFormatString1 and AfxFormatString2 pode ser útil na formatação de texto que aparece em uma caixa de mensagem.
Comentários
O primeiro formulário dessa função sobrecarregada exibe uma seqüência de caracteres de texto apontada por lpszText Na caixa de mensagem e usos nIDHelp Descrever um contexto de Ajuda. O contexto de ajuda é usado para saltar para um tópico de ajuda associado quando o usuário pressiona a tecla de Ajuda (F1 normalmente).
A segunda forma da função utiliza o recurso de seqüência de caracteres com o ID nIDPrompt Para exibir uma mensagem na caixa de mensagem. A página de ajuda associada for encontrada e o valor de nIDHelp. Se o valor padrão de nIDHelp é usado (– 1), a ID do recurso de seqüência de caracteres, nIDPrompt, é usado no contexto de Ajuda. Para obter mais informações sobre a definição de contextos de Ajuda, consulte Observação técnica 28.
Exemplo
// A simple message box, with only the OK button.
AfxMessageBox(_T("Simple message box."));
// A message box that uses a string from a string table
// with yes and no buttons and the stop icon.
// NOTE: nStringID is an integer that contains a valid id of
// a string in the current resource.
AfxMessageBox(nStringID, MB_YESNO|MB_ICONSTOP);
Requisitos
Cabeçalho: afxwin.h