Функция PagePaintHook


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

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

Синтаксис 

UINT_PTR CALLBACK PagePaintHook(
    HWND hdlg,
    UINT uiMsg,
    WPARAM wParam,
    LPARAM lParam
);

Параметры

hdlg

[in] Дескриптор диалогового окна Параметры страницы (Page Setup).

uiMsg

[in] Идентифицирует принимаемое сообщение.

wParam

[in] Устанавливает дополнительную информацию о сообщении. Точное значение зависит от величины параметра uiMsg.

lParam

[in] Устанавливает дополнительную информацию о сообщении. Точное значение зависит от величины параметра uiMsg.

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

Если фильтр - процедура возвращает значение ИСТИНА (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

Размещение и совместимость PagePaintHook

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 3.1 и выше

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

-

Заголовочный файл

 

- объявлено в

Commdlg.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz