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

Статья
03/01/2024

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

Синтаксис

BOOL GdiEndPageEMF(
  HANDLE SpoolFileHandle,
  DWORD  dwOptimization
);

Параметры

SpoolFileHandle

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

dwOptimization

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

EMF_PP_COLOR_OPTIMIZATION

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

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

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

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

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

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

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

Оптимизацией цвета, управляемой параметром dwOptimization , также можно управлять путем задания элемента dwColorOptimizationATTRIBUTE_INFO_2 или ATTRIBUTE_INFO_3 структур. Этой оптимизацией также можно управлять с помощью атрибута цвета Unidrv *ChangeColorModeOnDoc? (см. раздел Атрибуты цвета).

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

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	winppi.h (включая Winppi.h)
Библиотека	Gdi32.Lib
DLL	Gdi32.dll

См. также раздел

GdiPlayPageEMF

GdiStartPageEMF

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