DefFrameProcW, fonction (winuser.h)

Article
11/20/2024

Fournit le traitement par défaut pour tous les messages de fenêtre que la procédure de fenêtre d’une fenêtre frame multi-document (MDI) ne traite pas. Tous les messages de fenêtre qui ne sont pas traités explicitement par la procédure de fenêtre doivent être transmis à la fonction DefFrameProc , et non à la fonction DefWindowProc.

Syntaxe

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

Paramètres

[in] hWnd

Type : HWND

Handle de la fenêtre frame MDI.

[in] hWndMDIClient

Type : HWND

Handle vers la fenêtre du client MDI.

[in] uMsg

Type : uiNT

Message à traiter.

[in] wParam

Type : WPARAM

Informations supplémentaires spécifiques aux messages.

[in] lParam

Type : LPARAM

Informations supplémentaires spécifiques aux messages.

Valeur de retour

Type : LRESULT

La valeur de retour spécifie le résultat du traitement du message et dépend du message. Si le paramètre hWndMDIClient est NULL, la valeur de retour est la même que pour la fonction DefWindowProc.

Remarques

Quand la procédure de fenêtre d’une application ne gère pas un message, elle transmet généralement le message à la fonction DefWindowProc pour traiter le message. Les applications MDI utilisent les fonctions DefFrameProc et de DefMDIChildProc au lieu de DefWindowProc pour fournir le traitement des messages par défaut. Tous les messages qu’une application passe généralement à DefWindowProc (tels que les messages non clients et le message WM_SETTEXT) doivent être transmis à DefFrameProc à la place. La fonction DefFrameProc gère également les messages suivants.

Message	Réponse
WM_COMMAND	Active la fenêtre enfant MDI choisie par l’utilisateur. Ce message est envoyé lorsque l’utilisateur choisit une fenêtre enfant MDI dans le menu fenêtre de la fenêtre frame MDI. L’identificateur de fenêtre qui accompagne ce message identifie la fenêtre enfant MDI à activer.
WM_MENUCHAR	Ouvre le menu fenêtre de la fenêtre enfant MDI active lorsque l’utilisateur appuie sur la combinaison de touches Alt+ – (moins).
WM_SETFOCUS	Transmet le focus clavier à la fenêtre cliente MDI, qui à son tour la transmet à la fenêtre enfant MDI active.
WM_SIZE	Redimensionne la fenêtre cliente MDI pour qu’elle corresponde à la zone cliente de la nouvelle fenêtre frame. Si la procédure de fenêtre frame dimensionne la fenêtre cliente MDI à une autre taille, elle ne doit pas transmettre le message à la fonction DefWindowProc.

Note

L’en-tête winuser.h définit DefFrameProc comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winuser.h (include Windows.h)
bibliothèque	User32.lib
DLL	User32.dll