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 andere Initialisierungsaufgaben auszuführen, die sich auf die Darstellung des Dialogfelds auswirken.

#define WM_INITDIALOG                   0x0110

Die Parameter

wParam

Ein Handle für das Steuerelement, um den Standardtastaturfokus zu erhalten. Das System weist den Standardtastaturfokus nur zu, wenn die Dialogfeldprozedur WAHR zurückgibt.

lParam

Zusätzliche Initialisierungsdaten. Diese Daten werden als lParam-Parameter in einem Aufruf der CreateDialogIndirectParam-, CreateDialogParam-, DialogBoxIndirectParam- oder DialogBoxParam-Funktion an das System übergeben, die zum Erstellen des Dialogfelds verwendet wird. 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 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 Standardtastaturfokus 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 Standardtastaturfokus erhält, ist immer das erste Steuerelement im Dialogfeld, das sichtbar ist, nicht deaktiviert ist und über das WS_TABSTOP Format verfügt. Wenn die Dialogfeldprozedur WAHR 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 FALSE nur zurückgeben, wenn sie den Tastaturfokus auf eines der Steuerelemente des Dialogfelds festgelegt hat.

Anforderungen

Siehe auch

Referenz

CreateDialogIndirectParam

CreateDialogParam

DialogBoxIndirectParam

DialogBoxParam

SetFocus

Konzeptionell

Dialogfelder

Weitere Ressourcen

PROPSHEETPAGE