Funzione MessageBoxA (winuser.h)

Visualizza una finestra di dialogo modale contenente un'icona di sistema, un set di pulsanti e un breve messaggio specifico dell'applicazione, ad esempio informazioni sullo stato o sugli errori. La finestra di messaggio restituisce un valore intero che indica il pulsante su cui l'utente ha fatto clic.

Sintassi

int MessageBoxA(
  [in, optional] HWND   hWnd,
  [in, optional] LPCSTR lpText,
  [in, optional] LPCSTR lpCaption,
  [in]           UINT   uType
);

Parametri

[in, optional] hWnd

Tipo: HWND

Handle per la finestra proprietaria della finestra di messaggio da creare. Se questo parametro è NULL, la finestra di messaggio non ha una finestra di proprietario.

[in, optional] lpText

Tipo: LPCTSTR

Messaggio da visualizzare. Se la stringa è costituita da più righe, è possibile separare le righe utilizzando un ritorno a capo e/o un carattere di avanzamento riga tra ogni riga.

[in, optional] lpCaption

Tipo: LPCTSTR

Titolo della finestra di dialogo. Se questo parametro è NULL, il titolo predefinito è Error.

[in] uType

Tipo: UINT

Contenuto e comportamento della finestra di dialogo. Questo parametro può essere una combinazione di flag dai gruppi di flag seguenti.

Per indicare i pulsanti visualizzati nella finestra di messaggio, specificare uno dei valori seguenti.

Per visualizzare un'icona nella finestra di messaggio, specificare uno dei valori seguenti.

Per indicare il pulsante predefinito, specificare uno dei valori seguenti.

Per indicare la modalità della finestra di dialogo, specificare uno dei valori seguenti.

Per specificare altre opzioni, usare uno o più dei valori seguenti.

Valore restituito

Tipo: int

Se in una finestra di messaggio è presente un pulsante di Annulla , la funzione restituisce il valore IDCANCEL se viene premuto il tasto ESC o se è selezionato il pulsante annulla . Se la finestra di messaggio non ha pulsante Annulla, premere ESC non avrà alcun effetto, a meno che non sia presente un pulsante MB_OK. Se viene visualizzato un pulsante MB_OK e l'utente preme ESC, il valore restituito sarà IDOK.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Se la funzione ha esito positivo, il valore restituito è uno dei valori delle voci di menu seguenti.

Osservazioni

Le icone di sistema seguenti possono essere usate in una finestra di messaggio impostando il parametro uType sul valore del flag corrispondente.

Icona	Valori dei flag
icona	MB_ICONHAND, MB_ICONSTOPo MB_ICONERROR
Icona	MB_ICONQUESTION
Icona	MB_ICONEXCLAMATION o MB_ICONWARNING
Icona	MB_ICONASTERISK o MB_ICONINFORMATION

L'aggiunta di due segni da destra a sinistra (RLM), rappresentati dal carattere di formattazione Unicode U+200F, all'inizio di una stringa di visualizzazione MessageBox viene interpretata dal motore di rendering messageBox in modo da far sì che venga eseguito il rendering dell'ordine di lettura di MessageBox come da destra a sinistra (RTL).

Quando si usa una finestra di messaggio modale di sistema per indicare che la memoria del sistema è insufficiente, le stringhe a cui punta il lpText e parametri lpCaption non devono essere prese da un file di risorse perché un tentativo di caricamento della risorsa potrebbe non riuscire.

Se si crea una finestra di messaggio mentre è presente una finestra di dialogo, usare un handle per la finestra di dialogo come parametro hWnd. Il parametro hWnd non deve identificare una finestra figlio, ad esempio un controllo in una finestra di dialogo.

Esempi

Nell'esempio seguente l'applicazione visualizza una finestra di messaggio che richiede all'utente un'azione dopo che si è verificata una condizione di errore. Nella finestra di messaggio viene visualizzato il messaggio che descrive la condizione di errore e come risolverlo. Lo stile MB_CANCELTRYCONTINUE indirizza MessageBox per fornire tre pulsanti con cui l'utente può scegliere come procedere. Lo stile MB_DEFBUTTON2 imposta lo stato attivo predefinito sul secondo pulsante della finestra di messaggio, in questo caso il pulsante Riprova.

int DisplayResourceNAMessageBox()
{
    int msgboxID = MessageBox(
        NULL,
        (LPCWSTR)L"Resource not available\nDo you want to try again?",
        (LPCWSTR)L"Account Details",
        MB_ICONWARNING | MB_CANCELTRYCONTINUE | MB_DEFBUTTON2
    );

    switch (msgboxID)
    {
    case IDCANCEL:
        // TODO: add code
        break;
    case IDTRYAGAIN:
        // TODO: add code
        break;
    case IDCONTINUE:
        // TODO: add code
        break;
    }

    return msgboxID;
}

L'immagine seguente mostra l'output dell'esempio di codice precedente:

Per un altro esempio di finestra di messaggio, vedere Visualizzazione di una finestra di messaggio.

Fabbisogno

Vedere anche

concettuale

finestre di dialogo

FlashWindow

MessageBeep

MessageBoxEx

MessageBoxIndirect

altre risorse

riferimento

SetForegroundWindow