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。