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 objeto ou seqüência de caracteres terminada por caractere nulo que contém a mensagem a ser exibido na caixa de mensagem.nType
O estilo da caixa de mensagem.Aplicar o estilos de caixa de mensagem da caixa.nIDHelp
A identificação de contexto de ajuda para a mensagem; 0 indica que o contexto de Ajuda do aplicativo padrão será usado.nIDPrompt
Uma identificação exclusiva usada para fazer referência a uma seqüência de caracteres na tabela de seqüência de caracteres.
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 o botão foi selecionado.
IDCANCEL O Cancelar botão foi selecionado.
IDIGNORE Ignore O botão foi selecionado.
IDNO não o botão foi selecionado.
IDOK O OK botão foi selecionado.
IDRETRY novamente o botão foi selecionado.
IDYES O Sim botão foi selecionado.
Se uma caixa de mensagem tem um botão Cancelar, o IDCANCEL valor será retornado se a tecla ESC é pressionada ou se o botão Cancelar é selecionado.Se a caixa de mensagem com nenhum botão Cancelar, pressionando a tecla ESC não tem efeito.
As funções AfxFormatString1 e AfxFormatString2 pode ser útil na formatação de texto que aparece em uma caixa de mensagem.
Comentários
O primeiro formulário isso sobrecarregado função exibe uma seqüência de texto apontada pelo lpszText na caixa de mensagem e usa nIDHelp para 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).
O segundo formulário da função usa o recurso de seqüência de caracteres com a ID nIDPrompt para exibir uma mensagem na caixa de mensagem.Página de ajuda associada é encontrada e o valor de nIDHelp.Se o valor padrão de nIDHelp é usado (– 1), a identificação de recurso de cadeia de caracteres, nIDPrompt, é usado no contexto de Ajuda.Para obter mais informações sobre a definição de contextos de Ajuda, consulte técnico Observação 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