AfxMessageBox
Muestra un cuadro de mensaje en la pantalla.
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
Señala a un objeto de CString o una cadena terminada en null que contiene el mensaje que se mostrará en el cuadro de mensaje.nType
El estilo del cuadro de mensaje.Aplica estilos de cuadro de mensaje cualquiera de los al cuadro.nIDHelp
El Id. de contexto de Ayuda para el mensaje; 0 indica que el contexto de Ayuda de la aplicación se utilizará.nIDPrompt
Un identificador único que se usa para hacer referencia a una cadena en la tabla de cadenas.
Valor devuelto
Cero si no hay memoria suficiente para mostrar el cuadro de mensaje; si no, uno de los valores siguientes se devuelve:
El botón de anulación deIDABORTThe era seleccionado.
El botón Cancelar deIDCANCELThe era seleccionado.
IDIGNORE The omite el botón está seleccionado.
IDNO The ningún botón está seleccionado.
El botón ACEPTAR deIDOKThe era seleccionado.
El botón tryIDRETRY The era seleccionado.
El botón de Sí deIDYESThe era seleccionado.
Si un cuadro de mensaje tiene un botón Cancelar, el valor de IDCANCEL se devolverá si o se presiona la tecla ESC o el botón Cancelar está seleccionado.Si el cuadro de mensaje no tiene ningún botón Cancelar, presionar la tecla ESC no tiene ningún efecto.
Las funciones AfxFormatString1 y AfxFormatString2 pueden resultar útiles en el texto de formato que aparece en un cuadro de mensaje.
Comentarios
El primer formulario de esta función sobrecargada muestra una cadena de texto designada por a lpszText en el cuadro de mensaje y utiliza nIDHelp para describir un contexto de Ayuda.El contexto de Ayuda se utiliza para saltar a un tema de Ayuda asociado cuando el usuario presione la tecla de ayuda (normalmente F1).
El segundo formato de la función utiliza el recurso de cadena con el identificador nIDPrompt para mostrar un mensaje en el cuadro de mensaje.La página de ayuda asociado se encuentra con el valor de nIDHelp.Si el valor predeterminado de nIDHelp se utiliza (– 1), el Id. de recurso de cadena, nIDPrompt, se utiliza para el contexto de Ayuda.Para obtener más información sobre la definición de contextos de Ayuda, vea nota técnica 28.
Ejemplo
// 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
Header: afxwin.h