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 un oggetto CString o una stringa con terminazione null che contiene il messaggio da visualizzare nella finestra di messaggio.nType
Stile della finestra di messaggio. Applicare qualsiasi stile della finestra di messaggio alla casella.nIDHelp
ID del contesto della Guida per il messaggio; 0 indica che sarà utilizzato il contesto predefinito della Guida dell'applicazione.nIDPrompt
ID univoco utilizzato per fare riferimento a una stringa nella tabella di stringhe.
Valore restituito
Zero se la memoria per visualizzare la finestra di messaggio è insufficiente; in caso contrario, viene restituito uno dei valori seguenti:
IDABORT È stato selezionato il pulsante Interrompi.
IDCANCEL È stato selezionato il pulsante Annulla.
IDIGNORE È stato selezionato il pulsante Ignora.
IDNO È stato selezionato il pulsante No.
IDOK È stato selezionato il pulsante OK.
IDRETRY È stato selezionato il pulsante Riprova.
IDYES È stato selezionato il pulsante Sì.
Se è presente un pulsante Annulla nella finestra del messaggio, il valore IDCANCEL verrà restituito se viene premuto il tasto ESC o il pulsante Annulla. Se la finestra di messaggio non dispone di un pulsante Annulla, premendo ESC non verrà generato alcun effetto.
Le funzioni AfxFormatString1 e AfxFormatString2 possono essere utili nella formattazione di testo che appare in una finestra di messaggio.
Note
Il primo form di questa funzione in overload visualizza 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 form della funzione utilizza la risorsa di tipo stringa con l'ID nIDPrompt per visualizzare un messaggio nella finestra di messaggio. La pagina della Guida associata è stata individuata tramite il valore di nIDHelp. Se viene utilizzato il valore predefinito di nIDHelp (- 1), l'ID di risorsa della stringa, nIDPrompt, viene utilizzato per 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
Intestazione: afxwin.h