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。除非驱动程序在 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。