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

Статья
02/07/2025

Метод 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 вызывается из метода Unidrv IPrintOemDriverUni::D rvUniTextOut, если этот метод не может создать текстовую строку с помощью загружаемых шрифтов, либо потому, что шрифт недоступен или поворачивается. IPrintOemUni::TextOutAsBitmap должен создать растровое изображение текста и отправить его на устройство печати.

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

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	prcomoem.h (include Prcomoem.h)

См. также

IPrintOemDriverUni::D rvUniTextOut

IPrintOemUni

IPrintOemUni::GetImplementedMethod

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