Función de devolución de llamada LPCFHOOKPROC (commdlg.h)

Artículo
08/22/2023

Recibe mensajes o notificaciones destinados al procedimiento de cuadro de diálogo predeterminado del cuadro de diálogo Fuente . Se trata de un procedimiento de devolución de llamada definido por la aplicación o definido por la biblioteca que se usa con la función ChooseFont .

El tipo LPCFHOOKPROC define un puntero a esta función de devolución de llamada. CFHookProc es un marcador de posición para el nombre de función definido por la aplicación.

Sintaxis

LPCFHOOKPROC Lpcfhookproc;

UINT_PTR Lpcfhookproc(
  HWND unnamedParam1,
  UINT unnamedParam2,
  WPARAM unnamedParam3,
  LPARAM unnamedParam4
)
{...}

Parámetros

unnamedParam1

Identificador del cuadro de diálogo Fuente para el que está pensado el mensaje.

unnamedParam2

Identificador del mensaje que se recibe.

unnamedParam3

Información adicional acerca del mensaje. El significado exacto depende del valor del parámetro unnamedParam2 .

unnamedParam4

Información adicional acerca del mensaje. El significado exacto depende del valor del parámetro unnamedParam2 . Si el parámetro unnamedParam2 indica el mensaje WM_INITDIALOG , unnamedParam4 es un puntero a una estructura CHOOSEFONT que contiene los valores especificados cuando se creó el cuadro de diálogo.

Valor devuelto

Si el procedimiento de enlace devuelve cero, el procedimiento del cuadro de diálogo predeterminado procesa el mensaje.

Si el procedimiento de enlace devuelve un valor distinto de cero, el procedimiento del cuadro de diálogo predeterminado omite el mensaje.

Comentarios

Al usar la función ChooseFont para crear un cuadro de diálogo Fuente , puede proporcionar un procedimiento de enlace CFHookProc para procesar mensajes o notificaciones destinados al procedimiento del cuadro de diálogo. Para habilitar el procedimiento de enlace, use la estructura CHOOSEFONT que pasó a la función de creación de diálogos. Especifique la dirección del procedimiento de enlace en el miembro lpfnHook y especifique la marca CF_ENABLEHOOK en el miembro Flags .

El procedimiento de cuadro de diálogo predeterminado procesa el WM_INITDIALOG mensaje antes de pasarlo al procedimiento de enlace. Para todos los demás mensajes, el procedimiento de enlace recibe primero el mensaje. El valor devuelto del procedimiento de enlace determina si el procedimiento del cuadro de diálogo predeterminado procesa el mensaje o lo omite.

Si el procedimiento de enlace procesa el mensaje WM_CTLCOLORDLG , debe devolver un identificador de pincel válido para pintar el fondo del cuadro de diálogo. En general, si el procedimiento de enlace procesa algún mensaje de WM_CTLCOLOR* , debe devolver un identificador de pincel válido para pintar el fondo del control especificado.

No llame a la función EndDialog desde el procedimiento de enlace. En su lugar, el procedimiento de enlace puede llamar a la función PostMessage para publicar un mensaje de WM_COMMAND con el valor IDABORT en el procedimiento del cuadro de diálogo. Publicar IDABORT cierra el cuadro de diálogo y hace que la función del cuadro de diálogo devuelva FALSE. Si necesita saber por qué el procedimiento de enlace cerró el cuadro de diálogo, debe proporcionar su propio mecanismo de comunicación entre el procedimiento de enlace y la aplicación.

Puede subclase los controles estándar de un cuadro de diálogo común. Sin embargo, el procedimiento del cuadro de diálogo también puede subclase de los controles. Por este motivo, debe subclase controlar cuándo el procedimiento de enlace procesa el mensaje WM_INITDIALOG . Esto garantiza que el procedimiento de subclase reciba los mensajes específicos del control antes del procedimiento de subclase establecido por el procedimiento del cuadro de diálogo.

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	commdlg.h (incluye Windows.h)