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

Artículo
08/22/2023

Función de devolución de llamada definida por la aplicación o definida por la biblioteca que se usa con la función PrintDlg . El procedimiento de enlace recibe mensajes o notificaciones destinados al procedimiento de cuadro de diálogo predeterminado del cuadro de diálogo Configurar impresión .

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

Sintaxis

LPSETUPHOOKPROC Lpsetuphookproc;

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

Parámetros

unnamedParam1

Identificador del cuadro de diálogo Configurar impresión para el que está previsto 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 .

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

El cuadro de diálogo Configurar impresión se ha reemplazado por el cuadro de diálogo Configurar página , que las nuevas aplicaciones deben usar. Sin embargo, por compatibilidad, la función PrintDlg sigue admitiendo la visualización del cuadro de diálogo Configurar impresión . Puede proporcionar un procedimiento de enlace SetupHookProc para que el cuadro de diálogo Configurar impresión procese mensajes o notificaciones destinados al procedimiento del cuadro de diálogo.

Para habilitar el procedimiento de enlace, use la estructura PRINTDLG que pasó a la función de creación de diálogos. Especifique la dirección del procedimiento de enlace en el miembro lpfnSetupHook y especifique la marca PD_ENABLESETUPHOOK 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. A continuación, el valor devuelto del procedimiento de enlace determina si el procedimiento de diálogo predeterminado procesa el mensaje o lo omite.

Si el procedimiento de enlace procesa el mensaje de 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 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

Requisito	Value
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)