WM_INITDIALOG

Il messaggio WM_INITDIALOG viene inviato alla procedura di dialogo casella immediatamente prima che venga visualizzata una finestra di dialogo. Finestra di dialogo casella procedure in genere utilizzano questo messaggio per inizializzare i controlli e svolgere altre attività di inizializzazione influiscono sull'aspetto della finestra di dialogo.

WM_INITDIALOG hwndFocus = wParam (HWND); / / handle del controllo per ricevere lo stato attivo lInitParam = lParam;       / / parametro di inizializzazione 
 

Parametri

hwndFocus
Valore di wParam. Identifica il controllo per ricevere il focus della tastiera predefinita. Il sistema assegna il focus della tastiera predefinito solo se la procedura di casella di dialogo restituisce TRUE.
lInitParam
Valore lParam. Specifica i dati di inizializzazione aggiuntivo. Questi dati viene passati al sistema come parametro in una chiamata alla CreateDialogIndirectParam, CreateDialogParam, DialogBoxIndirectParamo DialogBoxParam funzione utilizzata per creare la finestra di dialogo lParamInit . Per lastre di proprietà, questo parametro è un puntatore ai PROPSHEETPAGE struttura utilizzata per creare la pagina. Questo parametro è zero se viene utilizzata qualsiasi altra finestra di dialogo casella funzione di creazione.

Valori restituiti

La procedura di casella di dialogo deve restituire TRUE per dirigere il sistema per impostare il focus della tastiera per il controllo dato da hwndFocus. In caso contrario, essa deve restituire FALSE per impedire il sistema di impostare il focus della tastiera predefinita.

La procedura di casella di dialogo deve restituire il valore direttamente. Il valore DWL_MSGRESULT impostato dalla funzione SetWindowLong viene ignorato.

Osservazioni

Il controllo di ricevere il focus della tastiera predefinita è sempre il primo controllo nella finestra di dialogo che è visibile, non disattivato, e che ha lo stile WS_TABSTOP. Quando la procedura di casella di dialogo restituisce TRUE, il sistema controlla il controllo per garantire che la procedura non ha disattivato. Se è stato disabilitato, il sistema imposta stato attivo al controllo successivo che è visibile, non disattivato, e ha la WS_TABSTOP.

Un'applicazione può restituire FALSE solo se ha impostato il focus della tastiera su uno dei controlli nella finestra di dialogo.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarata in winuser.

Vedi anche

Panoramica di finestre di dialogo, finestra di dialogo casella messaggi, CreateDialogIndirectParam, CreateDialogParam, DialogBoxIndirectParam, DialogBoxParam, PROPSHEETPAGE, SetFocus

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

Index