int AfxMessageBox ( LPCTSTR lpszText, UINT nType = MB_OK, UINT nIDHelp = 0 );
int AFXAPI AfxMessageBox ( UINT nIDPrompt, UINT nType = MB_OK, UINT nIDHelp = (UINT) -1 );
Valor devuelto
Cero si no hay suficiente memoria para mostrar el cuadro de mensaje; de lo contrario uno de los siguientes valores se devuelve:
Si un cuadro de mensaje tiene un botón Cancelar, el valor IDCANCEL será devuelto si se presiona la tecla ESC o el botón Cancelar está seleccionado. Si el cuadro de mensaje no tiene ningún botón Cancelar, pulse la tecla ESC no tiene ningún efecto.
Las funciones AfxFormatString1 y AfxFormatString2 pueden ser útiles en formato de texto que aparece en un cuadro de mensaje.
Parámetros
lpszText
Apunta a un objeto CString o una cadena terminada en nulo que contiene el mensaje que se mostrará en el cuadro de mensaje.
nType
El estilo del cuadro de me&nsaje. Aplicar cualquiera de los estilos de cuadro de mensaje a la box.nbsp;
nIDHelp
El ID de contexto de ayuda para el mensaje; 0 indica que se utilizará el contexto de ayuda predeterminado de la aplicación.
nIDPrompt
Un ID exclusivo utilizado para hacer referencia a una cadena en la tabla de cadenas.
Observaciones
Muestra un cuadro de mensaje en la pantalla. La primera forma de esta función sobrecargada muestra una cadena de texto apuntada por lpszText en el cuadro de mensaje y utiliza nIDHelp para describir un contexto de ayuda. El contexto se utiliza para saltar a un tema de ayuda asociado cuando el usuario presiona la tecla de ayuda (normalmente F1).
La segu&nda forma de la función utiliza el recurso de cadena con el ID nIDPrompt para mostrar un mensaje en el cuadro de mensaje. La página de ayuda asociada se encuentra mediante el valor de nIDHelp. Si se utiliza el valor predeterminado de nIDHelp (-1), el identificador de recurso de cadena, nIDPrompt, se utiliza para el contexto de la ayuda. Para obtener más información acerca de la definición de contextos de ayuda, consulte el artículo temas de ayuda en la Guía del programador de Visual C++ y técnica nota 28.nbsp;
Vea tambié&nnbsp;CWnd::MessageBox