共用方式為

IPrintOemUni：：TextOutAsBitmap 方法 （prcomoem.h）

  • 發行項

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。

要求

要求 價值
目標平臺 桌面
標頭 prcomoem.h （include Prcomoem.h）

另請參閱

IPrintOemDriverUni：:D rvUniTextOut

IPrintOemUni

IPrintOemUni：：GetImplementedMethod