Metodo IConsole::MessageBox (mmc.h)
Visualizza una finestra di messaggio.
Sintassi
HRESULT MessageBox(
[in] LPCWSTR lpszText,
[in] LPCWSTR lpszTitle,
[in] UINT fuStyle,
[out] int *piRetval
);
Parametri
[in] lpszText
Puntatore a una stringa con terminazione Null contenente il messaggio da visualizzare.
[in] lpszTitle
Puntatore a una stringa con terminazione Null utilizzata per il titolo della finestra di messaggio. Se questo parametro è NULL, viene usato il titolo predefinito "Error".
[in] fuStyle
Valore che specifica un set di flag di bit che determinano il contenuto e il comportamento della finestra di messaggio. Questo parametro può essere una combinazione di flag dai gruppi di flag seguenti ricavati dalla documentazione relativa a MessageBox dell'API Windows.
Specificare uno dei flag seguenti per indicare quali pulsanti vengono visualizzati nella finestra di messaggio.
MB_ABORTRETRYIGNORE
La finestra di messaggio contiene tre pulsanti: Interrompi, Riprova e Ignora.
MB_OK
La finestra di messaggio contiene un pulsante: OK. Questo è il valore predefinito.
MB_OKCANCEL
La finestra di messaggio contiene due pulsanti: OK e Annulla.
MB_RETRYCANCEL
La finestra di messaggio contiene due pulsanti: Riprova e Annulla.
MB_YESNO
La finestra di messaggio contiene due pulsanti: Sì e No.
MB_YESNOCANCEL
La finestra di messaggio contiene tre pulsanti: Sì, No e Annulla.
Specificare uno dei flag seguenti per indicare quale icona viene visualizzata nella finestra di messaggio:
MB_ICONEXCLAMATION, MB_ICONWARNING
Nella finestra di messaggio viene visualizzata un'icona punto esclamativo.
MB_ICONINFORMATION, MB_ICONASTERISK
Nella finestra di messaggio viene visualizzata un'icona costituita da un "I" in un cerchio.
MB_ICONQUESTION
Nella finestra di messaggio viene visualizzata un'icona del punto interrogativo.
MB_ICONSTOP,
MB_ICONERROR, MB_ICONHAND
Nella finestra di messaggio viene visualizzata un'icona del segno di arresto.
Specificare uno dei flag seguenti per indicare il pulsante predefinito:
MB_DEFBUTTON1
Il primo pulsante è il pulsante predefinito, a meno che non venga specificato uno degli altri flag in questo gruppo come impostazione predefinita.
MB_DEFBUTTON2
Il secondo pulsante è il pulsante predefinito.
MB_DEFBUTTON3
Il terzo pulsante è il pulsante predefinito.
MB_DEFBUTTON4
Il quarto pulsante è il pulsante predefinito.
Specificare uno dei flag seguenti per indicare la modalità della finestra di dialogo:
MB_APPLMODAL
L'utente deve rispondere alla finestra di messaggio prima di continuare a lavorare nella finestra corrente. Tuttavia, l'utente può passare alle finestre di altre applicazioni e lavorare in tali finestre. Il valore predefinito è MB_APPLMODAL se non viene specificato né MB_SYSTEMMODAL néMB_TASKMODAL .
MB_SYSTEMMODAL
Tutte le applicazioni vengono sospese fino a quando l'utente non risponde alla finestra di messaggio. Le finestre di messaggio modali di sistema vengono usate per informare l'utente di errori gravi e potenzialmente dannosi che richiedono attenzione immediata e devono essere utilizzati con moderazione.
MB_TASKMODAL
Simile a MB_APPLMODAL, ma non utile all'interno di un'applicazione MFC (Microsoft Foundation Classes). Questo flag è riservato a un'applicazione o a una libreria chiamante che non dispone di un handle di finestra disponibile.
Inoltre, è possibile specificare i flag seguenti:
MB_DEFAULT_DESKTOP_ONLY
Il desktop che attualmente riceve l'input deve essere un desktop predefinito; in caso contrario, la funzione ha esito negativo. Un desktop predefinito è un'applicazione eseguita dopo che l'utente ha eseguito l'accesso.
MB_HELP
Aggiunge un pulsante Della Guida alla finestra di messaggio. La scelta del pulsante ? o la pressione di F1 genera un evento della Guida.
MB_RIGHT
Il testo è giustificato a destra.
MB_RTLREADING
Visualizza il messaggio e didascalia testo utilizzando l'ordine di lettura da destra a sinistra per i sistemi ebrei e arabi.
MB_SETFOREGROUND
La finestra di messaggio diventa la finestra in primo piano. Internamente, il sistema operativo chiama la funzione SetForegroundWindow per la finestra di messaggio.
MB_TOPMOST
La finestra di messaggio viene creata con lo stile della finestra WS_EX_TOPMOST .
MB_SERVICE_NOTIFICATION
Il chiamante è un servizio che notifica un evento all'utente. La funzione visualizza una finestra di messaggio sul desktop attivo corrente, anche se non è presente alcun utente connesso al computer.
Per altre informazioni sull'uso di questo flag, vedere la funzione MessageBox .
MB_SERVICE_NOTIFICATION_NT3x
Questo valore corrisponde al valore definito per MB_SERVICE_NOTIFICATION per le versioni precedenti di Windows.
[out] piRetval
Puntatore al valore restituito.
Valore restituito
Questo metodo può restituire uno di questi valori.
Commenti
MessageBox non deve essere usato per visualizzare gli errori che si verificano quando lo snap-in non ha lo stato attivo. Generalmente
MessageBox deve essere usato solo quando l'errore richiede attenzione all'utente e quando il riquadro dei risultati contiene informazioni utili nonostante l'errore.
Nella maggior parte dei casi, il controllo OCX del messaggio MMC è un modo più appropriato per visualizzare i messaggi di errore. Per altre informazioni, vedere Using the MMC Message OCX Control.For more information, see Using the MMC Message OCX Control.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | mmc.h |
| DLL | Mmcndmgr.dll |