GETINFO_GLYPHSTRING結構(printoem.h)
GETINFO_GLYPHSTRING 結構會作為 UNIFONTOBJ_GetInfo 回呼函式的輸入。
語法
typedef struct _GETINFO_GLYPHSTRING {
DWORD dwSize;
DWORD dwCount;
DWORD dwTypeIn;
PVOID pGlyphIn;
DWORD dwTypeOut;
PVOID pGlyphOut;
DWORD dwGlyphOutSize;
} GETINFO_GLYPHSTRING, *PGETINFO_GLYPHSTRING;
成員
dwSize
指定 GETINFO_GLYPHSTRING 結構的大小,以位元組為單位。 這個值是由 UNIFONTOBJ_GetInfo 呼叫者提供。
dwCount
指定 pGlyphIn 和 pGlyphOut所指向之陣列中的元素數目。 這個值是由 UNIFONTOBJ_GetInfo 呼叫者提供。
dwTypeIn
指定 pGlyphIn 所指向的字元規範數位類型。 有效值如下所示:
價值 | 定義 |
---|---|
TYPE_GLYPHHANDLE | TpGlyphIn 數位元素的類型為 HGLYPH,或裝置字型圖像的句柄。 針對 dwTypeIn的這個值,dwTypeOut 的有效值為 TYPE_UNICODE 或 TYPE_TRANSDATA。 |
TYPE_GLYPHID | pGlyphIn 數位元素的類型為 DWORD,並包含已下載 TrueType 字型字元字元的字元標識碼。 針對 dwTypeIn的這個值,dwTypeOut 的有效值為 TYPE_UNICODE 或 TYPE_GLYPHHANDLE。 |
由 UNIFONTOBJ_GetInfo 呼叫者提供。
pGlyphIn
字元規範陣列的指標。 陣列專案類型是由 dwTypeIn表示。 這個值是由 UNIFONTOBJ_GetInfo 呼叫者提供。
dwTypeOut
指定 pGlyphOut 所指向的字元規範數位類型。 有效值如下所示:
價值 | 定義 |
---|---|
TYPE_GLYPHHANDLE | pGlyphOut 陣列元素的類型為 HGLYPH,或裝置字型字元的句柄。 只有在 dwTypeIn 已設定為 TYPE_GLYPHID 時,這個值才有效。 |
TYPE_TRANSDATA | pGlyphOut 陣列元素的類型 TRANSDATA。 只有在 dwTypeIn 已設定為 TYPE_GLYPHHANDLE 時,這個值才有效。 |
TYPE_UNICODE | pGlyph 陣列元素的類型為 WCHAR。 當 dwTypeIn 設定為 TYPE_GLYPHHANDLE 或 TYPE_GLYPHID 時,這個值是有效的。 |
由 UNIFONTOBJ_GetInfo 呼叫者提供。
pGlyphOut
呼叫端提供的指標,指向空的字元規範陣列。 數位會填入 Unidrv 的 UNIFONTOBJ_GetInfo 回呼函式。 陣列項目類型是由 dwTypeOut 表示。 此指標是由UNIFONTOBJ_GetInfo呼叫端所提供。
dwGlyphOutSize
指定 pGlyphOut 所指向之緩衝區的大小,以位元組為單位。 只有當 dwTypeIn 已設定為 TYPE_GLYPHHANDLE,且 dwTypeOut 已設定為 TYPE_TRANSDATA時,才會使用此成員。 如需詳細資訊,請參閱下列一節。
言論
若要將字元規範數位從某個類型轉換成另一種類型,轉譯外掛程式可以在呼叫 Unidrv 的 UNIFONTOBJ_GetInfo 回呼函式時提供GETINFO_GLYPHSTRING結構的位址。
如果從TYPE_GLYPHHANDLE轉換成TYPE_TRANSDATA,則必須呼叫 UNIFONTOBJ_GetInfo 兩次。
第一次呼叫 UNIFONTOBJ_GetInfo之前,轉譯外掛程式會填入 dwSize、dwCount、dwTypeIn,以及 pGlyphIn 成員,並將 dwGlyphOutSize 成員 設定為零。
UNIFONTOBJ_GetInfo 傳回之後,dwGlyphOutSize 成員會包含儲存已轉換字元串所需的緩衝區大小,以位元組為單位。
外掛程式會配置 dwGlyphOutSize 成員中所接收大小的記憶體區塊、將 pGlyphOut 成員設定為指向此記憶體區塊,並再次呼叫 UNIFONTOBJ_GetInfo。 UNIDRV 接著會將字串從 TYPE_GLYPHHANDLE 轉換成 TYPE_TRANSDATA。
轉譯外掛程式針對 dwTypeIn和 pGlyphIn 成員所指定的值,通常是先前接收為 dwType和 pGlyph 參數給 IPrintOemUni::OutputCharStr 方法的值。
要求
要求 | 價值 |
---|---|
標頭 | printoem.h (include Printoem.h) |