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。除非驱动程序在 DEVINFO 结构的 flGraphicsCaps 成员中设置GCAPS_ARBRUSHOPAQUE功能位，否则始终使用纯色画笔调用它。

pptlOrg

指向 POINTL 结构的指针，该结构定义两个画笔的画笔原点。

mix

pboFore的前景和后台光栅作（混合模式）。

返回值

该方法必须返回以下值之一。

返回代码	描述
S_OK	作成功。
E_FAIL	作失败。
E_NOTIMPL	未实现该方法。

言论

如果 IPrintOemUni::TextOutAsBitmap 该方法无法使用或旋转字体，则从 Unidrv 的 IPrintOemDriverUni：:D rvUniTextOut 方法调用该方法。 IPrintOemUni::TextOutAsBitmap 应创建文本的位图图像并将其发送到打印设备。

IPrintOemUni::TextOutAsBitmap 方法是可选的。如果呈现插件实现此方法，则插件的 IPrintOemUni：：GetImplementedMethod 方法在收到“TextOutAsBitmap”作为输入时必须返回S_OK。