共用方式為


IPrintOemUni::OutputCharStr 方法 (prcomoem.h)

方法 IPrintOemUni::OutputCharStr 可讓轉譯外掛程式控制字型圖像的列印。

語法

HRESULT OutputCharStr(
  PDEVOBJ     pdevobj,
  PUNIFONTOBJ pUFObj,
  DWORD       dwType,
  DWORD       dwCount,
  PVOID       pGlyph
);

參數

pdevobj

呼叫端提供的 DEVOBJ 結構指標。

pUFObj

呼叫端提供的 UNIFONTOBJ 結構指標。

dwType

呼叫端提供的值,指出 pGlyph 所指向的字元規範數位型態。 下列是有效值:

定義
TYPE_GLYPHHANDLE pGlyph 陣列元素是 HGLYPH 類型的字元句柄。
TYPE_GLYPHID pGlyph 陣列元素是 DWORD 類型的字元識別碼。

dwCount

呼叫端提供的值,代表 pGlyph 所指向陣列中的字元規範數目。

pGlyph

呼叫端提供的字元規範數位指標,其中陣列元素類型是以 dwType 表示。

傳回值

方法必須傳回下列其中一個值。

傳回碼 描述
S_OK
作業成功。
E_FAIL
作業失敗。
E_NOTIMPL
此方法尚未實作。

備註

方法 IPrintOemUni::OutputCharStr 用於支持無法辨識 Unidrv 所支援 PCL、CAPSL 或 PPDS 格式字元輸出命令的印表機。 其目的是允許轉譯外掛程式控制字型圖像的列印,並在必要時提供圖像替代。

如果轉譯外掛程式實作 IPrintOemUni::OutputCharStr 方法,Unidrv 會在每次準備好多任務緩衝處理字元字串時呼叫 方法。

方法會接收字元規範的陣列。 dwType 收到的值會指出標識符類型。

如果指定的字型是裝置字型,數位會包含字元句柄。 句柄必須轉譯為字元代碼或命令,然後傳送至列印後台處理程式,以列印裝置圖像。

如果指定的字型是虛 (TrueType) 字型,則陣列會包含字元標識碼。 標識子代表需要列印的先前下載圖像。

如果指定的字型是裝置字型,則 方法必須執行下列動作:

  1. dwTypeIn 設定為 TYPE_GLYPHHANDLE,並將 dwTypeOut 設定為 TYPE_TRANSDATA 配置GETINFO_GLYPHSTRING結構。
  2. 呼叫 UNIFONTOBJ_GetInfo 函式,傳遞GETINFO_GLYPHSTRING結構做為輸入,以取得字元轉譯為 TRANSDATA 結構內容。
  3. 呼叫 IPrintOemDriverUni::D rvWriteSpoolBuf 將 TRANSDATA 結構內容傳送至列印後台處理程式,以列印字元。
如果指定的字型是軟字型,則方法只能呼叫 IPrintOemDriverUni::D rvWriteSpoolBuf ,將命令傳送至列印多任務緩衝處理器,這會導致列印先前下載的字元。

方法是 IPrintOemUni::OutputCharStr 選擇性的。 如果轉譯外掛程式實作此方法,外掛程式的 IPrintOemUni::GetImplementedMethod 方法必須在收到 “OutputCharStr” 作為輸入時傳回S_OK。

如需詳細資訊,請參閱 自定義字型管理

規格需求

需求
目標平台 桌面
標頭 prcomoem.h (包括 Prcomoem.h)