Функция PagePaintHook

Фильтр - процедура PagePaintHook - это определяемая программой или библиотекой процедура повторного вызова, которая используется функцией PageSetupDlg. Функция принимает сообщения, которые позволяют вам настраивать рисование макета страницы в диалоговом окне Параметры страницы (Page Setup).

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

Синтаксис 

Параметры

hdlg

uiMsg

wParam

lParam

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

Если фильтр - процедура возвращает значение ИСТИНА (TRUE) для любого из первых трех сообщений WM_PSD_PAGESETUPDLG, WM_PSD_FULLPAGERECT или WM_PSD_MINMARGINRECT в порядке очередности рисования, то диалоговое окно не отправляет больше сообщений и не рисует в макете страницы до тех пор, пока в следующий раз системе не потребуется перерисовать макет страницы. Если фильтр - процедура возвращает значение ЛОЖЬ (FALSE) для всех трех сообщений, диалоговое окно отправляет оставшиеся сообщения в порядке следования рисования.

Если фильтр - процедура возвращает значение ИСТИНА (TRUE) для любого из оставшихся сообщений в порядке следования прорисовки, диалоговое окно не рисует соответствующую часть макета страницы. Если фильтр - процедура возвращает ЛОЖЬ (FALSE) для любого из этих сообщений, диалоговое окно рисует эту часть макета страницы.

Замечания

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

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

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

 

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

Смотри также 

Обзор Библиотека стандартных диалоговых окон, Функции, используемые библиотекой стандартных диалоговых окон, PageSetupDlg, PAGESETUPDLG