Функция обратного вызова LPPAGEPAINTHOOK (commdlg.h)
Получает сообщения, позволяющие настроить рисование примера страницы в диалоговом окне Параметры страницы . Процедура перехватчика 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) |
См. также раздел
Общая библиотека диалоговых окон
Основные понятия
Справочные материалы