WM_INITDIALOG messaggio

Inviato alla procedura della finestra di dialogo immediatamente prima che venga visualizzata una finestra di dialogo. Le procedure della finestra di dialogo usano in genere questo messaggio per inizializzare i controlli ed eseguire altre attività di inizializzazione che influiscono sull'aspetto della finestra di dialogo.

#define WM_INITDIALOG                   0x0110

Parametri

wParam

Handle per il controllo per ricevere lo stato attivo della tastiera predefinito. Il sistema assegna lo stato attivo della tastiera predefinito solo se la procedura della finestra di dialogo restituisce TRUE.

lParam

Dati di inizializzazione aggiuntivi. Questi dati vengono passati al sistema come parametro lParam in una chiamata alla funzione CreateDialogIndirectParam, CreateDialogParam, DialogBoxIndirectParam o DialogBoxParam utilizzata per creare la finestra di dialogo. Per i fogli delle proprietà, questo parametro è un puntatore alla struttura PROPSHEETPAGE usata per creare la pagina. Questo parametro è zero se viene usata qualsiasi altra funzione di creazione della finestra di dialogo.

Valore restituito

La procedura della finestra di dialogo deve restituire TRUE per indirizzare il sistema per impostare lo stato attivo della tastiera sul controllo specificato da wParam. In caso contrario, deve restituire FALSE per impedire al sistema di impostare lo stato attivo della tastiera predefinito.

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

Commenti

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

Un'applicazione può restituire FALSE solo se lo stato attivo della tastiera viene impostato su uno dei controlli della finestra di dialogo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Winuser.h (include Windows.h)

Vedi anche

Riferimento

CreateDialogIndirectParam

CreateDialogParam

DialogBoxIndirectParam

DialogBoxParam

Setfocus

Informazioni concettuali

Finestre di dialogo

Altre risorse

PROPSHEETPAGE