DefDlgProcW-Funktion (winuser.h)

Artikel
08/27/2023

Ruft die Standardmäßige Dialogfeldfensterprozedur auf, um eine Standardverarbeitung für alle Fenstermeldungen bereitzustellen, die von einem Dialogfeld mit einer privaten Fensterklasse nicht verarbeitet werden.

Syntax

LRESULT LRESULT DefDlgProcW(
  [in] HWND   hDlg,
  [in] UINT   Msg,
  [in] WPARAM wParam,
  [in] LPARAM lParam
);

Parameter

[in] hDlg

Typ: HWND

Ein Handle des Dialogfelds.

[in] Msg

Typ: UINT

Die Meldung.

[in] wParam

Typ: WPARAM

Zusätzliche meldungsspezifische Informationen.

[in] lParam

Typ: LPARAM

Zusätzliche meldungsspezifische Informationen.

Rückgabewert

Typ: LRESULT

Der Rückgabewert gibt das Ergebnis der Nachrichtenverarbeitung an und hängt von der gesendeten Nachricht ab.

Hinweise

Die DefDlgProc-Funktion ist die Fensterprozedur für die vordefinierte Klasse des Dialogfelds. Diese Prozedur ermöglicht die interne Verarbeitung des Dialogfelds, indem Nachrichten an die Dialogfeldprozedur weitergeleitet und die Standardverarbeitung für alle Meldungen ausgeführt wird, die von der Dialogfeldprozedur als FALSE zurückgegeben werden. Anwendungen, die benutzerdefinierte Fensterprozeduren für ihre benutzerdefinierten Dialogfelder erstellen, verwenden häufig DefDlgProc anstelle der Funktion DefWindowProc , um die Standardnachrichtenverarbeitung durchzuführen.

Anwendungen erstellen benutzerdefinierte Dialogfeldklassen, indem sie eine WNDCLASS-Struktur mit entsprechenden Informationen füllen und die Klasse mit der RegisterClass-Funktion registrieren. Einige Anwendungen füllen die Struktur mithilfe der GetClassInfo-Funktion aus und geben dabei den Namen des vordefinierten Dialogfelds an. In solchen Fällen ändern die Anwendungen vor der Registrierung mindestens das LpszClassName-Element . In allen Fällen muss das cbWndExtra-Element von WNDCLASS für eine benutzerdefinierte Dialogfeldklasse auf mindestens DLGWINDOWEXTRA festgelegt werden.

Die Funktion DefDlgProc darf nicht von einer Dialogfeldprozedur aufgerufen werden. Dies führt zu einer rekursiven Ausführung.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll