共用方式為

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

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

如需詳細資訊，請參閱 自訂字型管理。

要求

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