GetCharABCWidthsI

GetCharABCWidthsI 関数は、現在の TrueType フォントから指定範囲の連続するグリフインデックスの幅(論理単位)を取得する。この関数は TrueType フォントでのみ成功する。

GetCharABCWidthsI hdc, giFirst, cgi, pgi, pabc

hdc : [intptr] デバイスコンテキストのハンドル。
giFirst : [int] 現在のフォントから連続するグリフインデックス群の最初のグリフインデックス。このパラメータは pgi パラメータが NULL の場合にのみ使用される。
cgi : [int] グリフインデックスの数。
pgi : [var] グリフインデックスを含む配列へのポインタ。このパラメータが NULL の場合、代わりに giFirst パラメータが使用される。cgi パラメータはこの配列内のグリフインデックス数を指定する。
pabc : [var] 文字幅(論理単位)を受け取る ABC 構造体の配列へのポインタ。この配列は、cgi パラメータで指定したグリフインデックス数以上の ABC 構造体を含んでいなければならない。

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

解説

GetCharABCWidthsI 関数は、現在の TrueType
フォントから指定範囲の連続するグリフインデックスの幅(論理単位)を取得する。この関数は TrueType フォントでのみ成功する。

[戻り値]
関数が成功した場合、戻り値は 0 以外である。失敗した場合は 0 である。

[備考]
TrueType ラスタライザは、特定のポイントサイズが選択された後に ABC 文字間隔を提供する。A
スペースはグリフを配置する前に現在位置に加える距離である。B スペースはグリフの黒い部分の幅である。C
スペースはグリフの右側に空白を設けるために現在位置に加える距離である。総前進幅は A+B+C
で指定される。GetCharABCWidthsI 関数が文字に対して負の A または C
幅を返す場合、その文字はアンダーハングまたはオーバーハングを含んでいる。ABC
幅をフォントデザイン単位に変換するには、OUTLINETEXTMETRIC 構造体の otmEMSquare
メンバに格納されている値を使用すべきである。この値は GetOutlineTextMetrics
関数で取得できる。現在選択されているフォントの範囲外の文字にはデフォルト文字の ABC 幅が使用される。非 TrueType
フォントのグリフインデックスの幅を取得するには GetCharWidthI 関数を使用すべきである。

情報