AfxMessageBox

int AfxMessageBox ( LPCTSTR lpszText, UINT nType = MB_OK, UINT nIDHelp = 0 );

int AFXAPI AfxMessageBox ( UINT nIDPrompt, UINT nType = MB_OK, UINT nIDHelp = (UINT) -1 );

Valore restituito

Zero se non c'è abbastanza memoria per visualizzare la finestra di messaggio; in caso contrario uno dei seguenti valori viene restituito:

• IDABORT   È stato selezionato il pulsante di interruzione.
  
  
• IDCA&NCELnbsp;  È stato selezionato il pulsante Annulla.
  
  
• IDIG&NOREnbsp;  È stato selezionato il pulsante Ignora.
  
  
• ID&NOnbsp;  È stato selezionato il pulsante No.
  
  
• IDOK   È stato selezionato il pulsante OK.
  
  
• IDRETRY   È stato selezionato il pulsante Riprova.
  
  
• IDYES   È stato selezionato il pulsante Sì.

Se una finestra di messaggio ha un pulsante Annulla, il valore IDCANCEL sarà restituito se viene premuto il tasto ESC o viene selezionato il pulsante Annulla. Se la finestra di messaggio non ha nessun pulsante Annulla, premendo il tasto ESC non ha alcun effetto.

Le funzioni AfxFormatString1 e AfxFormatString2 possono essere utili nella formattazione di testo che viene visualizzato in una finestra di messaggio.

Parametri

lpszText

Punti a un oggetto CString o una stringa null-terminated contenente il messaggio da visualizzare nella finestra del messaggio.

nType

Lo stile della fi&nestra di messaggio. Applicare uno qualsiasi degli stili della finestra di messaggio per la box.nbsp;

nIDHelp

L'ID del contesto-guida per il messaggio; 0 indica il che contesto predefinito dell'applicazione verrà utilizzata.

nIDPrompt

Un ID univoco utilizzato per fare riferimento a una stringa nella tabella delle stringhe.

Osservazioni

Visualizza una finestra di messaggio sullo schermo. La prima forma di questa funzione in overload Visualizza una stringa di testo puntata da lpszText nella finestra del messaggio e utilizza nIDHelp per descrivere un contesto di aiuto. Il contesto viene utilizzato per passare a un argomento della Guida associato quando l'utente preme il tasto di aiuto (in genere F1).

La seco&nda forma della funzione utilizza la risorsa di tipo stringa con l'ID nIDPrompt per visualizzare un messaggio nella finestra del messaggio. La pagina della Guida associata si trova attraverso il valore di nIDHelp. Se viene utilizzato il valore predefinito di nIDHelp (-1), l'ID di risorsa stringa, nIDPrompt, viene utilizzato per il contesto. Per ulteriori informazioni sulla definizione di aiuto contesti, vedere l'articolo gli argomenti della guida in Visual C++ Programmer di Guide e tecnici nota 28.nbsp;

Vedere a&nchenbsp;CWnd::MessageBox