Función DefFrameProcA (winuser.h)

Artículo
11/20/2024

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 no se procesan explícitamente mediante el procedimiento de ventana deben pasarse a la función DefFrameProc , no a la función de DefWindowProc .

Sintaxis

LRESULT DefFrameProcA(
  [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 de

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 de es NULL, el valor devuelto es el mismo que para la función DefWindowProc.

Observaciones

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

Mensaje	Respuesta
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 ventana de la ventana 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 de cliente de 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 de 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	winuser.h (incluya Windows.h)
biblioteca de	User32.lib
DLL de	User32.dll