共用方式為

EngTextOut 函式 (winddi.h)

  • 發行項

EngTextOut函式會導致 GDI 在指定的位置轉譯一組字元。

語法

ENGAPI BOOL EngTextOut(
       SURFOBJ  *pso,
       STROBJ   *pstro,
       FONTOBJ  *pfo,
       CLIPOBJ  *pco,
       RECTL    *prclExtra,
       RECTL    *prclOpaque,
       BRUSHOBJ *pboFore,
       BRUSHOBJ *pboOpaque,
       POINTL   *pptlOrg,
  [in] MIX      mix
);

參數

pso

SURFOBJ結構的指標，描述要寫入的介面。

pstro

STROBJ結構的指標，定義要轉譯的字元，以及放置字元的位置。

pfo

FONTOBJ結構的指標，用來擷取字型及其字元的相關資訊。

pco

CLIPOBJ結構的指標，該結構定義必須完成轉譯的剪輯區域。 此剪輯區域外無法影響任何圖元。

prclExtra

RECTL結構的指標。 此參數應一律為 Null。

prclOpaque

RECTL 結構的指標，識別右下角獨佔的單一不透明矩形。 此矩形內的圖元 (非前景且未裁剪的圖元) 會以不透明筆刷轉譯。 這個矩形一律會系結要繪製的文字。 如果此參數為 Null，則不會轉譯不透明圖元。

pboFore

BRUSHOBJ結構的指標，表示要用於前景圖元的筆刷物件。 此筆刷一律為純色筆刷。

pboOpaque

BRUSHOBJ 結構的指標，代表不透明圖元的筆刷物件。 此筆刷的前景和背景混合模式都假設R2_COPYPEN。 除非驅動程式在DEVINFO結構的flGraphicsCaps成員中設定GCAPS_ARBRUSHOPAQUE功能位，否則一律會以純色筆刷呼叫。

pptlOrg

POINTL結構的指標，定義這兩個筆刷的筆刷原點。 如果呼叫 EngTextOut 時，此參數設定為 0，某些印表機驅動程式可能會不正確地列印色彩影像。 如需詳細資訊，請參閱。

[in] mix

指定 pboFore的前景和背景點陣作業 (混合模式) 。

傳回值

如果函式成功，則傳回值為 TRUE 。 否則，它會是 FALSE，並記錄錯誤碼。

備註

驅動程式在攔截DrvTextOut且無法轉譯字元時，應該呼叫EngTextOut。

注意如果驅動程式已攔截裝置受控介面的DrvTextOut，驅動程式就無法標點至EngTextOut。
 
EngTextOut的輸入參數會定義兩組圖元：前景和不透明。 驅動程式必須轉譯表面，因此結果與不透明圖元先以不透明筆刷轉譯的程式相同，然後前景圖元會以前景筆刷轉譯。 每個作業都會受限於裁剪。

當此函式的 pptlOrg 參數設定為 0 時，某些印表機驅動程式會在 Microsoft Windows Server 2003 (日文版本) 中不正確地列印色彩影像。 將 pptlOrg 設定為 0，即會解譯 Null 指標值，表示未定義筆刷原點。 若要避免這個問題，請在呼叫EngTextOut之前，使用將成員設定為 (0，0) 的 POINTL 結構位址初始化pptlOrg。

前景和不透明圖元會被視為螢幕，透過該畫面將色彩筆刷到表面。 字型的字元本身沒有色彩。

EngTextOut的輸入參數會定義一組圖像圖元、一組額外的矩形、不透明矩形和裁剪區域。 驅動程式必須計算並轉譯前景和不透明圖元的集合。

混合模式會定義傳入模式應該如何與裝置介面上已經的資料混合。 MIX 資料類型包含兩個封裝成單一 ULONG 的 ROP2 值。 低序位元組會定義前景點陣運算;下一個位元組會定義背景點陣作業。 如需點陣作業程式碼的詳細資訊，請參閱Microsoft Windows SDK檔。

規格需求

   
最低支援的用戶端 可在 Windows 2000 和更新版本的 Windows 作業系統中使用。
目標平台 Universal
標頭 winddi.h (包括 Winddi.h)
程式庫 Win32k.lib
Dll Win32k.sys

另請參閱

CLIPOBJ

DEVINFO

DrvTextOut

FONTOBJ

STROBJ

SURFOBJ