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

Метод IPrintOemDriverUni::D rvUniTextOut (prcomoem.h)

  • Статья

Метод IPrintOemDriverUni::DrvUniTextOut предоставляется драйвером Unidrv, чтобы подключаемый модуль отрисовки с помощью управляемой устройством поверхности рисования легко выводил текстовые строки.

Синтаксис

HRESULT DrvUniTextOut(
  SURFOBJ  *pso,
  STROBJ   *pstro,
  FONTOBJ  *pfo,
  CLIPOBJ  *pco,
  RECTL    *prclExtra,
  RECTL    *prclOpaque,
  BRUSHOBJ *pboFore,
  BRUSHOBJ *pboOpaque,
  POINTL   *pptlBrushOrg,
  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, он всегда будет вызываться с помощью сплошной цветной кисти.

pptlBrushOrg

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

mix

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

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

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

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

Комментарии

Метод IPrintOemDriverUni::DrvUniTextOut предоставляется Unidrv для использования путем отрисовки подключаемых модулей, поддерживающих поверхность рисования, управляемую устройством. Такие подключаемые модули отрисовки должны подключать функцию DrvTextOut Unidrv, и IPrintOemDriverUni::DrvUniTextOut метод предназначен для вызова из этой функции перехватчика. Функция перехватчика должна выполнять операции обрезки области текста и поворота текста. Затем он может вызвать IPrintOemDriverUni::DrvUniTextOut запрос Unidrv, чтобы создать текстовую строку с помощью загружаемых шрифтов (и выполнить вырезку на основе глифов).

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

Дополнительные сведения см. в разделе Обработка поверхностей Device-Managed.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть prcomoem.h (включая Prcomoem.h)