共用方式為


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之前,轉譯外掛程式會填入 dwSizedwCountdwTypeIn,以及 pGlyphIn 成員,並將 dwGlyphOutSize 成員 設定為零。

    UNIFONTOBJ_GetInfo 傳回之後,dwGlyphOutSize 成員會包含儲存已轉換字元串所需的緩衝區大小,以位元組為單位。

  • 外掛程式會配置 dwGlyphOutSize 成員中所接收大小的記憶體區塊、將 pGlyphOut 成員設定為指向此記憶體區塊,並再次呼叫 UNIFONTOBJ_GetInfo。 UNIDRV 接著會將字串從 TYPE_GLYPHHANDLE 轉換成 TYPE_TRANSDATA。

轉譯外掛程式針對 dwTypeInpGlyphIn 成員所指定的值,通常是先前接收為 dwTypepGlyph 參數給 IPrintOemUni::OutputCharStr 方法的值。

要求

要求 價值
標頭 printoem.h (include Printoem.h)

另請參閱

IPrintOemUni::OutputCharStr

UNIFONTOBJ_GetInfo