FONTOBJ_cGetGlyphs函式 (winddi.h)
FONTOBJ_cGetGlyphs函式是字型取用者的一項服務,可將字元句柄轉譯為圖像數據的指標,直到下一次呼叫FONTOBJ_cGetGlyphs為止。
語法
ULONG FONTOBJ_cGetGlyphs(
FONTOBJ *pfo,
[in] ULONG iMode,
ULONG cGlyph,
HGLYPH *phg,
PVOID *ppvGlyph
);
參數
pfo
FONTOBJ 結構的指標,其中包含要翻譯的字元句柄。
[in] iMode
指定數據是否會寫入為位圖或大綱物件。 此參數可以是下列其中一個值:
值 | 意義 |
---|---|
FO_GLYPHBITS | 數據將包含定義字元位圖的 GLYPHBITS 結構。 |
FO_PATHOBJ |
數據將包含 PATHOBJ 結構,這些結構會定義字元的大綱。
若要判斷路徑是否應該填滿或筆劃,字型取用者應該檢查IFIMETRICS結構的 flInfo 成員。 如果已設定FM_INFO_RETURNS_STROKES旗標,則應該筆劃路徑;否則,應該填入路徑。 |
cGlyph
指定要翻譯的字元數目。 程式代碼假設 (唯一可接受的值為 1,不論指定的值) 為何。
phg
驅動程式所提供 cGlyph HGLYPH 結構的數位指標。
ppvGlyph
接收 GLYPHDATA 結構地址的記憶體位置指標。 這個結構的第一個成員是 GLYPHDEF 等位,其包含 GLYPHBITS 結構或 PATHOBJ 結構的指標,視 iMode 參數的值而定。 如果 iMode 的值FO_GLYPHBITS, (ppvGlyph) ->gdf 包含 GLYPHBITS 結構的位址。如果 iMode 的值是FO_PATHOBJ, (ppvGlyph) -gdf> 包含 PATHOBJ 結構的位址。
傳回值
如果函式成功,傳回值就是傳遞至驅動程式的指標計數。 否則,它會是零,而且會記錄錯誤碼。
備註
如果驅動程式正在快取字型,就應該使用此函式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Windows 2000 和更新版本的 Windows 作業系統中使用。 |
目標平台 | Universal |
標頭 | winddi.h (包括 Winddi.h) |
程式庫 | Win32k.lib |
Dll | Win32k.sys |