Метод IPrintOemUni::TextOutAsBitmap (prcomoem.h)

Статья
02/26/2024

Метод IPrintOemUni::TextOutAsBitmap позволяет подключаемому модулем отрисовки создавать точечные изображения текстовой строки, если загружаемый шрифт недоступен.

Синтаксис

HRESULT TextOutAsBitmap(
  SURFOBJ  *pso,
  STROBJ   *pstro,
  FONTOBJ  *pfo,
  CLIPOBJ  *pco,
  RECTL    *prclExtra,
  RECTL    *prclOpaque,
  BRUSHOBJ *pboFore,
  BRUSHOBJ *pboOpaque,
  POINTL   *pptlOrg,
  MIX      mix
);

Параметры

pso

Указатель на структуру SURFOBJ , описывающую поверхность, на которой выполняется запись.

pstro

Указатель на структуру STROBJ , которая определяет отрисовываемые глифы и позиции для их размещения.

pfo

Указатель на структуру FONTOBJ , из которой извлекаются сведения о шрифте и его глифах.

pco

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

prclExtra

Указатель на структуру RECTL. GDI всегда присваивает этому параметру значение NULL в вызовах этой функции. Драйвер должен игнорировать его.

prclOpaque

Указатель на структуру RECTL , представляющую один непрозрачный прямоугольник. Этот прямоугольник является эксклюзивным снизу справа. Пиксели внутри этого прямоугольника (те, которые не являются передним планом и не обрезаны) должны отображаться с помощью непрозрачной кисти. Этот прямоугольник всегда ограничивает отрисовываемый текст. Если этот параметр имеет значение NULL, отрисовка непрозрачных пикселей не требуется.

pboFore

Указатель на структуру BRUSHOBJ , представляющую объект кисти, используемый для пикселей переднего плана. Эта кисть всегда будет кистью сплошного цвета.

pboOpaque

Указатель на структуру BRUSHOBJ, представляющую непрозрачные пиксели. Предполагается, что режимы сочетания переднего плана и фона для этой кисти R2_COPYPEN. Если драйвер не задает бит возможностей GCAPS_ARBRUSHOPAQUE в элементе flGraphicsCaps структуры DEVINFO, он всегда будет вызываться с помощью сплошной цветной кисти.

pptlOrg

Указатель на структуру POINTL , которая определяет источник кисти для обеих кистей.

mix

Операции переднего плана и фоновые растровые операции (смешанные режимы) для pboFore.

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

Метод должен возвращать одно из следующих значений.

Код возврата	Описание
S_OK	Операция успешно выполнена.
E_FAIL	Операция не удалась.
E_NOTIMPL	Метод не реализован.

Метод IPrintOemUni::TextOutAsBitmap вызывается из метода IPrintOemDriverUni::D rvUniTextOut , если этот метод не может создать текстовую строку с помощью загружаемых шрифтов, так как шрифт недоступен или повернут. IPrintOemUni::TextOutAsBitmap должен создать точечный рисунок текста и отправить его на устройство печати.

Метод IPrintOemUni::TextOutAsBitmap является необязательным. Если подключаемый модуль отрисовки реализует этот метод, метод IPrintOemUni::GetImplementedMethod должен возвращать S_OK при получении "TextOutAsBitmap" в качестве входных данных.