WM_INITDIALOG Nachricht

Wird unmittelbar vor der Anzeige eines Dialogfelds an die Dialogfeldprozedur gesendet. Dialogfeldverfahren verwenden in der Regel diese Nachricht, um Steuerelemente zu initialisieren und andere Initialisierungsaufgaben auszuführen, die sich auf das Aussehen des Dialogfelds auswirken.

#define WM_INITDIALOG                   0x0110

Parameter

wParam

Ein Handle zum Steuerelement, um den Standardtastaturfokus zu erhalten. Das System weist nur den Standardtastaturfokus zu, wenn die Dialogfeldprozedur TRUE zurückgibt.

lParam

Zusätzliche Initialisierungsdaten. Diese Daten werden an das System als lParam-Parameter in einem Aufruf des CreateDialogIndirectParam, CreateDialogParam, DialogBoxIndirectParam oder DialogBoxParam übergeben, die zum Erstellen des Dialogfelds verwendet wird. Für Eigenschaftenblätter 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 zu leiten, um den Tastaturfokus auf das von wParam angegebene Steuerelement festzulegen. Andernfalls sollte FALSE zurückgegeben werden, um zu verhindern, dass das System den Standardtastataturfokus festlegt.

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

Hinweise

Das Steuerelement zum Empfangen des Standardtastaturfokus ist immer das erste Steuerelement im Dialogfeld, das sichtbar, nicht deaktiviert ist und das die WS_TABSTOP-Formatvorlage aufweist. Wenn die Dialogfeldprozedur TRUE zurückgibt, überprüft das System das Steuerelement, um sicherzustellen, dass die Prozedur sie nicht deaktiviert hat. Wenn sie deaktiviert wurde, legt das System den Tastaturfokus auf das nächste Steuerelement fest, das sichtbar ist, nicht deaktiviert und weist die WS_TABSTOP auf.

Eine Anwendung kann NUR FALSE zurückgeben, wenn der Tastaturfokus auf einen der Steuerelemente des Dialogfelds festgelegt wurde.

Requirements (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 (enthalten Windows.h)

Siehe auch

Referenz

CreateDialogIndirectParam

CreateDialogParam

DialogBoxIndirectParam

DialogBoxParam

SetFocus

Konzept

Dialogfelder

Andere Ressourcen

PROPSHEETPAGE