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

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

Синтаксис

BOOL GdiPlayPageEMF(
  HANDLE SpoolFileHandle,
  HANDLE hemf,
  RECT   *prectDocument,
  RECT   *prectBorder,
  RECT   *prectClip
);

Параметры

SpoolFileHandle

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

hemf

Дескриптор страницы, предоставленный вызывающим абонентом, полученный путем вызова GdiGetPageHandle, определяющий страницу, для которой должны воспроизводиться записи.

prectDocument

Предоставленный вызывающим элементом указатель на структуру RECT , задающий прямоугольник, в который должна быть нарисована страница.

prectBorder

Предоставленный вызывающим элементом указатель на структуру RECT, задающий прямоугольник границы страницы (при наличии). Может иметь значение NULL.

prectClip

Предоставленный вызывающим элементом указатель на структуру RECT, указывающий координаты обрезной области страницы (при наличии). Может иметь значение NULL.

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

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

Комментарии

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

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

Обработчик печати использует prectClip для описания прямоугольной области для печати и prectDocument , чтобы описать прямоугольник, в который должна поместиться страница документа (или обрезанная область). Если аргумент prectClip имеет значение NULL, будет напечатана вся страница документа. Для значений prectClip, отличных от NULL, будет напечатана только часть страницы документа в области клипа. Затем функция GdiPlayPageEMF выполняет операции масштабирования и преобразования, необходимые для размещения страницы документа (или выбранной части) в прямоугольнике.

Параметр prectBorder , если он не равен NULL, описывает прямоугольник сплошной границы, нарисованный вокруг страницы документа. Если аргумент prectBorder имеет значение NULL, такая граница не будет нарисована.

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

Требования

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

GdiEndPageEMF