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
Referencia