DefFrameProcA-Funktion (winuser.h)

Artikel
11/20/2024

Stellt die Standardverarbeitung für alle Fenstermeldungen bereit, die die Fensterprozedur eines MDI-Framefensters (Multiple-Document Interface) nicht verarbeitet. Alle Fenstermeldungen, die nicht explizit von der Fensterprozedur verarbeitet werden, müssen an die DefFrameProc--Funktion übergeben werden, nicht an die DefWindowProc--Funktion.

Syntax

LRESULT DefFrameProcA(
  [in] HWND   hWnd,
  [in] HWND   hWndMDIClient,
  [in] UINT   uMsg,
  [in] WPARAM wParam,
  [in] LPARAM lParam
);

Parameter

[in] hWnd

Typ: HWND-

Ein Handle für das MDI-Rahmenfenster.

[in] hWndMDIClient

Typ: HWND-

Ein Handle für das MDI-Clientfenster.

[in] uMsg

Typ: UINT-

Die zu verarbeitende Nachricht.

[in] wParam

Typ: WPARAM-

Zusätzliche nachrichtenspezifische Informationen.

[in] lParam

Typ: LPARAM-

Zusätzliche nachrichtenspezifische Informationen.

Rückgabewert

Typ: LRESULT-

Der Rückgabewert gibt das Ergebnis der Nachrichtenverarbeitung an und hängt von der Nachricht ab. Wenn der hWndMDIClient Parameter NULL-ist, ist der Rückgabewert identisch mit der DefWindowProc--Funktion.

Bemerkungen

Wenn die Fensterprozedur einer Anwendung keine Nachricht verarbeitet, übergibt sie die Nachricht in der Regel an die DefWindowProc--Funktion, um die Nachricht zu verarbeiten. MDI-Anwendungen verwenden die DefFrameProc- und DefMDIChildProc- Funktionen anstelle von DefWindowProc-, um die Standardnachrichtenverarbeitung bereitzustellen. Alle Nachrichten, die eine Anwendung normalerweise an DefWindowProc übergeben würde (z. B. Nichtclientnachrichten und die WM_SETTEXT Nachricht), sollten stattdessen an DefFrameProc- übergeben werden. Die DefFrameProc--Funktion behandelt auch die folgenden Meldungen.

Nachricht	Antwort
WM_COMMAND	Aktiviert das untergeordnete MDI-Fenster, das der Benutzer auswählt. Diese Nachricht wird gesendet, wenn der Benutzer ein untergeordnetes MDI-Fenster aus dem Fenstermenü des MDI-Rahmenfensters auswählt. Der Fensterbezeichner, der diese Meldung begleitet, identifiziert das untergeordnete MDI-Fenster, das aktiviert werden soll.
WM_MENUCHAR	Öffnet das Fenstermenü des aktiven untergeordneten MDI-Fensters, wenn der Benutzer die TASTENkombination ALT+ – (minus) drückt.
WM_SETFOCUS	Übergibt den Tastaturfokus an das MDI-Clientfenster, das wiederum an das aktive untergeordnete MDI-Fenster übergibt.
WM_SIZE	Ändert die Größe des MDI-Clientfensters so, dass es in den Clientbereich des neuen Framefensters passt. Wenn die Framefensterprozedur das MDI-Clientfenster auf eine andere Größe vergrößert, sollte die Nachricht nicht an die DefWindowProc--Funktion übergeben werden.

Anmerkung

Der winuser.h-Header definiert DefFrameProc als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winuser.h (enthalten Windows.h)
Library	User32.lib
DLL-	User32.dll