Функция обратного вызова 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)