Función DefFrameProcW (winuser.h)

Artículo
08/27/2023

Proporciona procesamiento predeterminado para los mensajes de ventana que el procedimiento de ventana de una ventana de marco de interfaz de varios documentos (MDI) no procesa. Todos los mensajes de ventana que el procedimiento de ventana no procesa explícitamente deben pasarse a la función DefFrameProc , no a la función DefWindowProc .

Sintaxis

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

Parámetros

[in] hWnd

Tipo: HWND

Identificador de la ventana de marco MDI.

[in] hWndMDIClient

Tipo: HWND

Identificador de la ventana del cliente MDI.

[in] uMsg

Tipo: UINT

Mensaje que se va a procesar.

[in] wParam

Tipo: WPARAM

Información adicional específica del mensaje.

[in] lParam

Tipo: LPARAM

Información adicional específica del mensaje.

Valor devuelto

Tipo: LRESULT

El valor devuelto especifica el resultado del procesamiento del mensaje y depende del mensaje. Si el parámetro hWndMDIClient es NULL, el valor devuelto es el mismo que para la función DefWindowProc .

Comentarios

Cuando el procedimiento de ventana de una aplicación no controla un mensaje, normalmente pasa el mensaje a la función DefWindowProc para procesar el mensaje. Las aplicaciones MDI usan las funciones DefFrameProc y DefMDIChildProc en lugar de DefWindowProc para proporcionar el procesamiento de mensajes predeterminado. Todos los mensajes que una aplicación normalmente pasaría a DefWindowProc (como mensajes no cliente y el mensaje WM_SETTEXT ) deben pasarse a DefFrameProc en su lugar. La función DefFrameProc también controla los siguientes mensajes.

Mensaje	Response
WM_COMMAND	Activa la ventana secundaria MDI que elige el usuario. Este mensaje se envía cuando el usuario elige una ventana secundaria MDI en el menú de la ventana del marco MDI. El identificador de ventana que acompaña a este mensaje identifica la ventana secundaria MDI que se va a activar.
WM_MENUCHAR	Abre el menú de ventana de la ventana secundaria MDI activa cuando el usuario presiona la combinación de teclas ALT+ – (menos).
WM_SETFOCUS	Pasa el foco del teclado a la ventana del cliente MDI, que a su vez la pasa a la ventana secundaria MDI activa.
WM_SIZE	Cambia el tamaño de la ventana del cliente MDI para que se ajuste al área de cliente de la nueva ventana de marco. Si el procedimiento de ventana de marco cambia el tamaño de la ventana del cliente MDI a un tamaño diferente, no debe pasar el mensaje a la función DefWindowProc .

Nota

El encabezado winuser.h define DefFrameProc como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll