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 表示。
傳回值
方法必須傳回下列其中一個值。
傳回碼 | 描述 |
---|---|
|
作業成功。 |
|
作業失敗。 |
|
此方法尚未實作。 |
備註
方法 IPrintOemUni::OutputCharStr
用於支持無法辨識 Unidrv 所支援 PCL、CAPSL 或 PPDS 格式字元輸出命令的印表機。 其目的是允許轉譯外掛程式控制字型圖像的列印,並在必要時提供圖像替代。
如果轉譯外掛程式實作 IPrintOemUni::OutputCharStr
方法,Unidrv 會在每次準備好多任務緩衝處理字元字串時呼叫 方法。
方法會接收字元規範的陣列。 dwType 收到的值會指出標識符類型。
如果指定的字型是裝置字型,數位會包含字元句柄。 句柄必須轉譯為字元代碼或命令,然後傳送至列印後台處理程式,以列印裝置圖像。
如果指定的字型是虛 (TrueType) 字型,則陣列會包含字元標識碼。 標識子代表需要列印的先前下載圖像。
如果指定的字型是裝置字型,則 方法必須執行下列動作:
- 將 dwTypeIn 設定為 TYPE_GLYPHHANDLE,並將 dwTypeOut 設定為 TYPE_TRANSDATA 配置GETINFO_GLYPHSTRING結構。
- 呼叫 UNIFONTOBJ_GetInfo 函式,傳遞GETINFO_GLYPHSTRING結構做為輸入,以取得字元轉譯為 TRANSDATA 結構內容。
- 呼叫 IPrintOemDriverUni::D rvWriteSpoolBuf 將 TRANSDATA 結構內容傳送至列印後台處理程式,以列印字元。
方法是 IPrintOemUni::OutputCharStr
選擇性的。 如果轉譯外掛程式實作此方法,外掛程式的 IPrintOemUni::GetImplementedMethod 方法必須在收到 “OutputCharStr” 作為輸入時傳回S_OK。
如需詳細資訊,請參閱 自定義字型管理。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | prcomoem.h (包括 Prcomoem.h) |