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 |
|
Siehe auch
-
Referenz
-
Konzept
-
Andere Ressourcen