Функция GdiEndPageEMF (winppi.h)

Статья
02/07/2025

Функция GdiEndPageEMF завершает операции воспроизведения EMF для физической страницы задания печати с форматированием EMF.

Синтаксис

BOOL GdiEndPageEMF(
  HANDLE SpoolFileHandle,
  DWORD  dwOptimization
);

Параметры

SpoolFileHandle

Вызывающий дескриптор файла spool, полученный предыдущим вызовом GdiGetSpoolFileHandle.

dwOptimization

Флаги, предоставленные вызывающим абонентом. Определен следующий флаг:

EMF_PP_COLOR_OPTIMIZATION

Включите оптимизацию цвета. Дополнительные сведения см. в разделе "Примечания".

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

Если операция выполнена успешно, функция возвращает TRUE. В противном случае функция возвращает FALSE, а код ошибки можно получить путем вызова GetLastError.

Замечания

Функция GdiEndPageEMF экспортируется gdi32.dll для использования в функции PrintDocumentOnPrintProcessor обработчика печати.

Функция GdiEndPageEMF завершает обработку физической страницы и приводит к ее удалению с принтера. Обработчик печати должен вызывать GdiEndPageEMF в следующее время:

После размещения соответствующего количества страниц документов на физической странице путем вызова GdiPlayPageEMF. Обратите внимание, что GdiPlayPageEMF фактически не печатается в контексте устройства, а подготавливает структуру данных, описывающую текст и графику, которые должны быть напечатаны на физических страницах. Текст и графика печатаются в контексте устройства при вызове GdiEndPageEMF.
При вызове GdiGetDevmodeForPage указывает, что структура DEVMODEW страницы документа отличается от структуры DEVMODE предыдущей страницы.

Если эта функция вызывается с параметром dwOptimization значение EMF_PP_COLOR_OPTIMIZATION, то включена оптимизация цвета. Если dwOptimization установлено значение 0, оптимизация не выполняется. Если включена оптимизация цвета, наличие цвета в файле спула приводит к тому, что файл спула будет воспроизводиться цветом; Отсутствие цвета в файле спула приводит к тому, что файл спула будет воспроизводиться в монохромном режиме.

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

Кроме того, можно управлять оптимизацией цвета, управляемой параметром dwOptimization dwColorOptimization структуры ATTRIBUTE_INFO_2 или ATTRIBUTE_INFO_3. Эту оптимизацию также можно контролировать с помощью Unidrv *ChangeColorModeOnDoc? атрибут цвета (см. атрибуты цвета).

Дополнительные сведения см. в разделе Использование функций GDI впроцессоров печати.

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	winppi.h (include Winppi.h)
библиотеки	Gdi32.Lib
DLL	Gdi32.dll

См. также

GdiPlayPageEMF

GdiStartPageEMF

Поделиться через