FONTOBJ_cGetGlyphs

FONTOBJ_cGetGlyphs 関数は、グリフハンドルをグリフデータへのポインタに変換する、フォント利用者向けのサービスである。このポインタは次回の FONTOBJ_cGetGlyphs 呼び出しまで有効である。

FONTOBJ_cGetGlyphs pfo, iMode, cGlyph, phg, ppvGlyph

pfo : [var] 変換するグリフハンドルを含む FONTOBJ 構造体へのポインタ。
iMode : [int] 
cGlyph : [int] 変換するグリフ数を指定する。指定可能な値は 1 のみである(コードは指定値に関わらず 1 と仮定する)。
phg : [var] ドライバが指定する cGlyph 個の HGLYPH 構造体の配列へのポインタ。
ppvGlyph : [var] GLYPHDATA 構造体のアドレスを受け取るメモリ位置へのポインタ。この構造体の最初のメンバは GLYPHDEF 共用体で、iMode パラメータの値によって GLYPHBITS 構造体または PATHOBJ 構造体へのポインタを含む。iMode が FO_GLYPHBITS の場合、(*ppvGlyph)->gdf は GLYPHBITS 構造体のアドレスを含む。iMode が FO_PATHOBJ の場合、(*ppvGlyph)->gdf は PATHOBJ 構造体のアドレスを含む。

(プラグイン / モジュール : gdi32.dll)

解説

FONTOBJ_cGetGlyphs
関数は、グリフハンドルをグリフデータへのポインタに変換する、フォント利用者向けのサービスである。このポインタは次回の
FONTOBJ_cGetGlyphs 呼び出しまで有効である。

[戻り値]
関数が成功した場合、戻り値はドライバに渡されたポインタの個数である。失敗した場合は 0 を返し、エラーコードがログに記録される。

[備考]
この関数は、ドライバがフォントをキャッシュする場合に使用すべきである。

情報