WM_INITDIALOG messaggio

Inviato alla routine della finestra di dialogo immediatamente prima della visualizzazione di una finestra di dialogo. Le procedure della finestra di dialogo usano in genere questo messaggio per inizializzare i controlli ed eseguire qualsiasi altra attività di inizializzazione che influisce sull'aspetto della finestra di dialogo.

#define WM_INITDIALOG                   0x0110

Parametri

wParam

Handle per il controllo per ricevere lo stato attivo predefinito della tastiera. Il sistema assegna lo stato attivo predefinito della tastiera solo se la routine 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 usata per creare la finestra di dialogo. Per le finestre delle proprietà, questo parametro è un puntatore alla struttura PROPSHEETPAGE utilizzata 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 a 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 predefinito della tastiera.

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

Osservazioni:

Il controllo per ricevere lo stato attivo predefinito della tastiera è sempre il primo controllo della finestra di dialogo visibile, non disabilitato e con lo stile WS_TABSTOP . Quando la routine della finestra di dialogo restituisce TRUE, il sistema controlla il controllo per assicurarsi che la routine non l'abbia 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 ha impostato lo stato attivo della tastiera su uno dei controlli della finestra di dialogo.

Requisiti

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

Vedere anche

Riferimento

CreateDialogIndirectParam

CreateDialogParam

DialogBoxIndirectParam

DialogBoxParam

SetFocus

concettuale

Finestre di dialogo

Altre risorse

PROPSHEETPAGE