Función de devolución de llamada LPPAGESETUPHOOK (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 Configurar página . El procedimiento de enlace PageSetupHook es una función de devolución de llamada definida por la aplicación o definida por la biblioteca que se usa con la función PageSetupDlg .

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

Sintaxis

LPPAGESETUPHOOK Lppagesetuphook;

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

Parámetros

unnamedParam1

Identificador del cuadro de diálogo Configurar página 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 .

Si el parámetro unnamedParam2 indica el mensaje de WM_INITDIALOG , unnamedParam4 es un puntero a una estructura PAGESETUPDLG 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 PageSetupDlg para crear un cuadro de diálogo Configurar página , puede proporcionar un procedimiento de enlace PageSetupHook para procesar mensajes o notificaciones destinados al procedimiento del cuadro de diálogo. Para habilitar el procedimiento de enlace, use la estructura PAGESETUPDLG que pasó a la función de creación de diálogos. Especifique el puntero al procedimiento de enlace en el miembro lpfnPageSetupHook y especifique la marca PSD_ENABLEPAGESETUPHOOK 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)