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

Статья
02/07/2025

Метод 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 для использования подключаемыми модулями отрисовки, поддерживающими область рисования, управляемой устройством. Такие подключаемые модули отрисовки должны перехватывать функцию DrvText Out Unidrv, а метод IPrintOemDriverUni::DrvUniTextOut должен вызываться из этой функции перехватчика. Функция перехватчика должна выполнять операции с вырезки текстовых областей и поворота текста. Затем он может вызвать IPrintOemDriverUni::DrvUniTextOut, чтобы запросить Unidrv, чтобы создать текстовую строку с помощью скачиваемых шрифтов (и выполнить вырезку на основе глифов).

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

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

Требования

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

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