Функция обратного вызова LPPAGEPAINTHOOK (commdlg.h)

Статья
08/22/2023

Получает сообщения, позволяющие настроить рисование примера страницы в диалоговом окне Параметры страницы . Процедура перехватчика PagePaintHook — это определяемая приложением или библиотекой функция обратного вызова, используемая с функцией PageSetupDlg .

Тип LPPAGEPAINTHOOK определяет указатель на эту функцию обратного вызова. PagePaintHook — это заполнитель для определяемого приложением или библиотекой имени функции.

Синтаксис

LPPAGEPAINTHOOK Lppagepainthook;

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

Параметры

unnamedParam1

Дескриптор диалогового окна Параметры страницы .

unnamedParam2

Идентификатор получаемого сообщения.

unnamedParam3

Дополнительные сведения о сообщении. Точное значение зависит от значения параметра unnamedParam2 .

unnamedParam4

Дополнительные сведения о сообщении. Точное значение зависит от значения параметра unnamedParam2 .

Возвращаемое значение

Если процедура перехватчика возвращает значение TRUE для любого из первых трех сообщений последовательности рисования (WM_PSD_PAGESETUPDLG, WM_PSD_FULLPAGERECT или WM_PSD_MINMARGINRECT), диалоговое окно больше не отправляет сообщения и не рисует на странице образца до следующего раза, когда системе потребуется перерисовать пример страницы. Если процедура перехватчика возвращает значение FALSE для всех трех сообщений, диалоговое окно отправляет оставшиеся сообщения последовательности рисования.

Если процедура перехватчика возвращает значение TRUE для любого из оставшихся сообщений в последовательности рисования, диалоговое окно не рисует соответствующую часть образца страницы. Если процедура перехватчика возвращает значение FALSE для любого из этих сообщений, диалоговое окно рисует эту часть примера страницы.

Диалоговое окно Параметры страницы содержит изображение примера страницы, показывающее, как выбранные пользователем параметры влияют на внешний вид выходных данных. Изображение состоит из прямоугольника, представляющего выбранный тип бумаги или конверта, с прямоугольником с пунктирной линией, представляющим текущие поля, и символами частичного (греческого текста), чтобы показать, как текст выглядит на печатной странице. При использовании функции PageSetupDlg для создания диалогового окна Параметры страницы можно указать процедуру перехватчика PagePaintHook для настройки внешнего вида примера страницы.

Чтобы включить процедуру перехватчика, используйте структуру PAGESETUPDLG , переданную в функцию создания. Укажите указатель на процедуру перехватчика в элементе lpfnPagePaintHook и укажите флаг PSD_ENABLEPAGEPAINTHOOK в элементе Flags .

Всякий раз, когда диалоговое окно будет рисовать содержимое примера страницы, процедура перехватчика получает следующие сообщения в порядке их перечисления.

Сообщение	Значение
WM_PSD_PAGESETUPDLG	Диалоговое окно будет нарисовывает пример страницы. Процедура перехватчика может использовать это сообщение для подготовки к рисованию содержимого примера страницы.
WM_PSD_FULLPAGERECT	Диалоговое окно будет нарисовывает пример страницы. Это сообщение указывает ограничивающий прямоугольник примера страницы.
WM_PSD_MINMARGINRECT	Диалоговое окно будет нарисовывает пример страницы. В этом сообщении указывается прямоугольник полей.
WM_PSD_MARGINRECT	В диалоговом окне будет нарисована прямоугольник поля.
WM_PSD_GREEKTEXTRECT	Диалоговое окно будет рисовать греческий текст внутри прямоугольника поля.
WM_PSD_ENVSTAMPRECT	Диалоговое окно будет нарисована в прямоугольнике конверта образца страницы. Это сообщение отправляется только для конвертов.
WM_PSD_YAFULLPAGERECT	Диалоговое окно будет нарисовывает часть возвращаемого адреса страницы с примером конверта. Это сообщение отправляется для конвертов и других размеров бумаги.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	commdlg.h (включая Windows.h)