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.

Mensaje	Significado
WM_PSD_PAGESETUPDLG	El cuadro de diálogo está a punto de dibujar la página de ejemplo. El procedimiento de enlace puede usar este mensaje para preparar el dibujo del contenido de la página de ejemplo.
WM_PSD_FULLPAGERECT	El cuadro de diálogo está a punto de dibujar la página de ejemplo. Este mensaje especifica el rectángulo delimitador de la página de ejemplo.
WM_PSD_MINMARGINRECT	El cuadro de diálogo está a punto de dibujar la página de ejemplo. Este mensaje especifica el rectángulo de margen.
WM_PSD_MARGINRECT	El cuadro de diálogo está a punto de dibujar el rectángulo de margen.
WM_PSD_GREEKTEXTRECT	El cuadro de diálogo está a punto de dibujar el texto griego dentro del rectángulo de margen.
WM_PSD_ENVSTAMPRECT	El cuadro de diálogo está a punto de dibujar en el rectángulo sobre-stamp de una página de ejemplo de sobre. Este mensaje solo se envía para sobres.
WM_PSD_YAFULLPAGERECT	El cuadro de diálogo está a punto de dibujar la parte de la dirección de retorno de una página de ejemplo de sobre. Este mensaje se envía para sobres y otros tamaños de papel.

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)

Consulte también

Biblioteca de cuadros de diálogo comunes

Conceptual

PAGESETUPDLG

PageSetupDlg

Referencia