AfxMessageBox
Viene visualizzata una finestra di messaggio sullo schermo.
int AfxMessageBox(
LPCTSTR lpszText,
UINT nType = MB_OK,
UINT nIDHelp = 0
);
int AFXAPI AfxMessageBox(
UINT nIDPrompt,
UINT nType = MB_OK,
UINT nIDHelp = (UINT
) -1
);
Parametri
lpszText
Punta a CString oggetto o stringa con terminazione null che contiene il messaggio da visualizzare nella finestra di messaggio.nType
Lo stile della finestra di messaggio.Applicare uno di stili della finestra di messaggio nella casella.nIDHelp
ID del contesto del messaggio, 0 indica che il contesto predefinito della guida dell'applicazione verrà utilizzato.nIDPrompt
Un ID univoco utilizzato per fare riferimento a una stringa nella tabella di stringhe.
Valore restituito
Zero se non è memoria sufficiente per visualizzare la finestra di messaggio, in caso contrario, uno dei valori seguenti viene restituito:
IDABORT il pulsante di interruzione è stato selezionato.
IDCANCEL il pulsante Annulla è stato selezionato.
IDIGNORE il pulsante da ignorare è stato selezionato.
IDNO alcun pulsante è stato selezionato.
IDOK il pulsante OK è stato selezionato.
IDRETRY il pulsante di tentativi è stato selezionato.
IDYES il pulsante di sì è stato selezionato.
Se viene visualizzata una finestra di messaggio contenente un pulsante Annulla, il valore di IDCANCEL viene restituito se o viene premuto il tasto ESC o Annulla è selezionato.Se la finestra di messaggio non ha pulsante Annulla, premere ESC non ha alcun effetto.
Le funzioni AfxFormatString1 e AfxFormatString2 possono essere utili in testo di formattazione che viene visualizzato in una finestra di messaggio.
Note
Il primo form di questa funzione in overload verrà visualizzata una stringa di testo indicata da lpszText nella finestra di messaggio e utilizza nIDHelp per descrivere un contesto della guida.Il contesto della guida viene utilizzato per passare a un argomento della Guida associato quando l'utente preme il tasto della guida (in genere F1).
Il secondo formato della funzione utilizza la risorsa di tipo stringa con ID nIDPrompt per visualizzare un messaggio nella finestra di messaggio.La pagina della Guida associata viene trovata con il valore di nIDHelp.Se il valore predefinito di nIDHelp viene utilizzato (– 1), la risorsa di tipo stringa l'ID, nIDPrompt, viene utilizzato il contesto della guida.Per ulteriori informazioni sulla definizione dei contesti della guida, vedere nota tecnica 28.
Esempio
// 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);
Requisiti
Header: afxwin.h