Funzione DefMDIChildProcA (winuser.h)

Articolo
11/20/2024

Fornisce l'elaborazione predefinita per qualsiasi messaggio di finestra che la routine della finestra di una finestra figlio MDI (Multiple-Document Interface) non elabora. Un messaggio di finestra non elaborato dalla routine della finestra deve essere passato alla funzione DefMDIChildProc, non alla funzione DefWindowProc.

Sintassi

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

Parametri

[in] hWnd

Tipo: HWND

Handle per la finestra figlio 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.

Osservazioni

La funzione DefMDIChildProc presuppone che la finestra padre della finestra figlio MDI identificata dal parametro hWnd sia stata creata con la classe MDICLIENT .

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 DefMDIChildProc. Inoltre, DefMDIChildProc gestisce anche i messaggi seguenti.

Messaggio	Risposta
WM_CHILDACTIVATE	Esegue l'elaborazione dell'attivazione quando le finestre figlio MDI vengono ridimensionate, spostate o visualizzate. Questo messaggio deve essere passato.
WM_GETMINMAXINFO	Calcola le dimensioni di una finestra figlio MDI ingrandita, in base alle dimensioni correnti della finestra del client MDI.
WM_MENUCHAR	Passa il messaggio alla finestra cornice MDI.
WM_MOVE	Ricalcola le barre di scorrimento del client MDI, se presenti.
WM_SETFOCUS	Attiva la finestra figlio se non è la finestra figlio MDI attiva.
WM_SIZE	Esegue operazioni necessarie per modificare le dimensioni di una finestra, in particolare per ottimizzare o ripristinare una finestra figlio MDI. Il mancato passaggio di questo messaggio alla funzione DefMDIChildProc genera risultati estremamente indesiderati.
WM_SYSCOMMAND	Gestisce i comandi di menu della finestra: SC_NEXTWINDOW, SC_PREVWINDOW, SC_MOVE, SC_SIZEe SC_MAXIMIZE.

Nota

L'intestazione winuser.h definisce DefMDIChildProc 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