WM_INITDIALOG Nachricht

Wird unmittelbar vor der Anzeige eines Dialogfelds an die Dialogfeldprozedur gesendet. Dialogfeldprozeduren verwenden diese Meldung in der Regel, um Steuerelemente zu initialisieren und alle anderen Initialisierungsaufgaben auszuführen, die sich auf die Darstellung des Dialogfelds auswirken.

#define WM_INITDIALOG                   0x0110

Parameter

wParam

Ein Handle für das Steuerelement, um den Standard-Tastaturfokus zu erhalten. Das System weist den Standard-Tastaturfokus nur zu, wenn die Dialogfeldprozedur TRUE zurückgibt.

lParam

Zusätzliche Initialisierungsdaten. Diese Daten werden als lParam-Parameter in einem Aufruf der Zum Erstellen des Dialogfelds verwendeten Funktionen CreateDialogIndirectParam, CreateDialogParam, DialogBoxIndirectParam oder DialogBoxParam an das System übergeben. Bei Eigenschaftenblättern ist dieser Parameter ein Zeiger auf die PROPSHEETPAGE-Struktur , die zum Erstellen der Seite verwendet wird. Dieser Parameter ist null, wenn eine andere Dialogfelderstellungsfunktion verwendet wird.

Rückgabewert

Die Dialogfeldprozedur sollte TRUE zurückgeben, um das System anweisen, den Tastaturfokus auf das von wParam angegebene Steuerelement festzulegen. Andernfalls sollte false zurückgegeben werden, um zu verhindern, dass das System den Standard-Tastaturfokus festlegt.

Die Dialogfeldprozedur sollte den Wert direkt zurückgeben. Der von der SetWindowLong-Funktion festgelegte DWL_MSGRESULT Wert wird ignoriert.

Bemerkungen

Das Steuerelement, das den Standardmäßigen Tastaturfokus erhalten soll, ist immer das erste Steuerelement im Dialogfeld, das sichtbar, nicht deaktiviert ist und die WS_TABSTOP Stil aufweist. Wenn die Dialogfeldprozedur TRUE zurückgibt, überprüft das System das Steuerelement, um sicherzustellen, dass die Prozedur es nicht deaktiviert hat. Wenn es deaktiviert wurde, legt das System den Tastaturfokus auf das nächste Steuerelement fest, das sichtbar, nicht deaktiviert ist und über das WS_TABSTOP verfügt.

Eine Anwendung kann FALSE nur zurückgeben, wenn sie den Tastaturfokus auf eines der Steuerelemente des Dialogfelds festgelegt hat.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Winuser.h (einschließlich Windows.h)

Siehe auch

Referenz

CreateDialogIndirectParam

CreateDialogParam

DialogBoxIndirectParam

DialogBoxParam

SetFocus

Konzept

Dialogfelder

Andere Ressourcen

PROPSHEETPAGE