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

Recibe mensajes que permiten personalizar el dibujo de la página de ejemplo en el cuadro de diálogo Configurar página . El procedimiento de enlace PagePaintHook 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 LPPAGEPAINTHOOK define un puntero a esta función de devolución de llamada. PagePaintHook es un marcador de posición para el nombre de función definido por la aplicación o la biblioteca.

Sintaxis

LPPAGEPAINTHOOK Lppagepainthook;

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

Parámetros

unnamedParam1

Identificador del cuadro de diálogo Configurar página .

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 TRUE para cualquiera de los tres primeros mensajes de una secuencia de dibujo (WM_PSD_PAGESETUPDLG, WM_PSD_FULLPAGERECT o WM_PSD_MINMARGINRECT), el cuadro de diálogo no envía más mensajes y no dibuja en la página de ejemplo hasta la próxima vez que el sistema necesite volver a dibujar la página de ejemplo. Si el procedimiento de enlace devuelve FALSE para los tres mensajes, el cuadro de diálogo envía los mensajes restantes de la secuencia de dibujo.

Si el procedimiento de enlace devuelve TRUE para cualquiera de los mensajes restantes de una secuencia de dibujo, el cuadro de diálogo no dibuja la parte correspondiente de la página de ejemplo. Si el procedimiento de enlace devuelve FALSE para cualquiera de estos mensajes, el cuadro de diálogo dibuja esa parte de la página de ejemplo.

Comentarios

El cuadro de diálogo Configurar página incluye una imagen de una página de ejemplo que muestra cómo afectan las selecciones del usuario a la apariencia de la salida impresa. La imagen consta de un rectángulo que representa el tipo de papel o sobre seleccionado, con un rectángulo de línea de puntos que representa los márgenes actuales y caracteres parciales (texto griego) para mostrar el aspecto del texto en la página impresa. Al usar la función PageSetupDlg para crear un cuadro de diálogo Configurar página , puede proporcionar un procedimiento de enlace PagePaintHook para personalizar la apariencia de la página de ejemplo.

Para habilitar el procedimiento de enlace, use la estructura PAGESETUPDLG que pasó a la función de creación. Especifique el puntero al procedimiento de enlace en el miembro lpfnPagePaintHook y especifique la marca PSD_ENABLEPAGEPAINTHOOK en el miembro Flags .

Cada vez que el cuadro de diálogo está a punto de dibujar el contenido de la página de ejemplo, el procedimiento de enlace recibe los siguientes mensajes en el orden en el que se muestran.

Requisitos

Consulte también

Biblioteca de cuadros de diálogo comunes

Conceptual

PAGESETUPDLG

PageSetupDlg

Referencia