MessageBoxIndirect

La funzione MessageBoxIndirect crea, Visualizza e gestisce una finestra di messaggio. La finestra di messaggio contiene il testo del messaggio definito dall'applicazione e titolo, tutta l'icona e qualsiasi combinazione di pulsanti predefiniti.

int (MessageBoxIndirect LPMSGBOXPARAMS  lpMsgBoxParams / / indirizzo della struttura per messaggio / / box parametri);
 

Parametri

lpMsgBoxParams
Puntatore a una struttura MSGBOXPARAMS che contiene le informazioni utilizzate per visualizzare la finestra di messaggio.

Valori restituiti

Il valore restituito è pari a zero, se non vi è memoria sufficiente per creare la finestra di messaggio.

Se la funzione ha esito positivo, il valore restituito è una delle voci di menu seguenti valori restituiti dalla finestra di dialogo:

Valore Significato
IDABORT È stato selezionato il pulsante di interruzione.
IDCANCEL È stato selezionato il pulsante Annulla.
IDIGNORE Ignorare è stato selezionato il pulsante.
IDNO È stato selezionato alcun tasto.
IDOK È stato selezionato il pulsante OK.
IDRETRY È stato selezionato il pulsante Riprova.
IDYES Sì è stato selezionato il pulsante.

Se una finestra di messaggio ha un pulsante Annulla, la funzione restituisce il valore IDCANCEL se viene premuto il tasto esc o se viene selezionato il pulsante Annulla. Produce alcun effetto se la finestra di messaggio non ha nessun pulsante Annulla, premendo esc.

Osservazioni

Quando si utilizza una finestra di messaggio di sistema modale per indicare che il sistema ha poca memoria, le stringhe a cui punta il lpszText e lpszCaption membri della struttura MSGBOXPARAMS non devono essere preso da un file di risorse, perché un tentativo di caricare la risorsa potrebbe non riuscire.

Quando un'applicazione chiama MessageBoxIndirect e specifica i flag MB_ICONHAND e MB_SYSTEMMODAL per il dwStyle membro della struttura MSGBOXPARAMS , il sistema visualizza la finestra di messaggio risultante indipendentemente dalla memoria disponibile. Quando questi flag vengono specificati, il sistema limita la lunghezza del testo casella messaggio su tre righe. Il sistema non non automaticamente spezzare le linee da stare in una finestra di messaggio, tuttavia, quindi la stringa del messaggio deve contenere ritorni a rompere le righe nei luoghi appropriati.

Se si crea una finestra di messaggio, mentre una finestra di dialogo è presente, utilizzare l'handle della finestra di dialogo come parametro hWnd . Il parametro hWnd non dovrebbe identificare una finestra figlio, ad esempio un controllo in una finestra di dialogo.

Windows 95:Il sistema può supportare un massimo di 16.364 handle della finestra.

Descrizione

nbsp; Windows &NT: richiede una versione 4.0 o successive.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Non supportato.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.
Unicode:Implementato come versioni Unicode e ANSI su Windows NT.

Vedi anche

Panoramica di finestre di dialogo, finestra di dialogo casella funzioni, MessageBox, MessageBoxEx, MSGBOXPARAMS

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index