Funzione DefFrameProcW (winuser.h)

Articolo
11/20/2024

Fornisce l'elaborazione predefinita per tutti i messaggi di finestra che la routine della finestra di una finestra cornice MDI (Multiple-Document Interface) non elabora. Tutti i messaggi di finestra che non vengono elaborati in modo esplicito dalla routine della finestra devono essere passati alla funzione DefFrameProc , non alla funzione DefWindowProc .

Sintassi

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

Parametri

[in] hWnd

Tipo: HWND

Handle per la finestra cornice MDI.

[in] hWndMDIClient

Tipo: HWND

Handle per la finestra del client MDI.

[in] uMsg

Tipo: UINT

Messaggio da elaborare.

[in] wParam

Tipo: WPARAM

Informazioni aggiuntive specifiche del messaggio.

[in] lParam

Tipo: LPARAM

Informazioni aggiuntive specifiche del messaggio.

Valore restituito

Tipo: LRESULT

Il valore restituito specifica il risultato dell'elaborazione del messaggio e dipende dal messaggio. Se il parametro hWndMDIClient è NULL, il valore restituito corrisponde a quello della funzione DefWindowProc.

Osservazioni

Quando la routine della finestra di un'applicazione non gestisce un messaggio, in genere passa il messaggio alla funzione defWindowProc per elaborare il messaggio. Le applicazioni MDI usano le funzioni di DefFrameProc e DefMDIChildProc anziché DefWindowProc per fornire l'elaborazione predefinita dei messaggi. Tutti i messaggi che un'applicazione in genere passa a DefWindowProc (ad esempio i messaggi non client e il messaggio di WM_SETTEXT) devono essere passati a DefFrameProc. La funzione DefFrameProc gestisce anche i messaggi seguenti.

Messaggio	Risposta
WM_COMMAND	Attiva la finestra figlio MDI selezionata dall'utente. Questo messaggio viene inviato quando l'utente sceglie una finestra figlio MDI dal menu della finestra cornice MDI. L'identificatore della finestra che accompagna questo messaggio identifica la finestra figlio MDI da attivare.
WM_MENUCHAR	Apre il menu della finestra figlio MDI attiva quando l'utente preme la combinazione di tasti ALT+ (meno).
WM_SETFOCUS	Passa lo stato attivo della tastiera alla finestra del client MDI, che a sua volta passa alla finestra figlio MDI attiva.
WM_SIZE	Ridimensiona la finestra del client MDI in modo che si adatti all'area client della nuova finestra cornice. Se la routine della finestra cornice ridimensiona la finestra del client MDI a dimensioni diverse, non deve passare il messaggio alla funzione DefWindowProc.

Nota

L'intestazione winuser.h definisce DefFrameProc come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winuser.h (include Windows.h)
libreria	User32.lib
dll	User32.dll