GetCharABCWidthsW

GetCharABCWidths 関数は、現在の TrueType フォントから指定範囲の連続する文字の幅(論理単位)を取得する。この関数は TrueType フォントでのみ成功する。(Unicode)

GetCharABCWidthsW hdc, wFirst, wLast, lpABC

hdc : [intptr] デバイスコンテキストのハンドル。
wFirst : [int] 現在のフォントから連続する文字群の最初の文字。
wLast : [int] 現在のフォントから連続する文字群の最後の文字。
lpABC : [var] 文字幅(論理単位)を受け取る ABC 構造体の配列へのポインタ。この配列は、uFirstChar および uLastChar パラメータで指定された範囲の文字数以上の ABC 構造体を含んでいなければならない。

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

解説

GetCharABCWidths 関数は、現在の TrueType
フォントから指定範囲の連続する文字の幅(論理単位)を取得する。この関数は TrueType フォントでのみ成功する。(Unicode)

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

[備考]
TrueType ラスタライザは、特定のポイントサイズが選択された後に ABC 文字間隔を提供する。A
スペースはグリフを配置する前に現在位置に加える距離である。B スペースはグリフの黒い部分の幅である。C
スペースはグリフの右側に空白を設けるために現在位置に加える距離である。総前進幅は A+B+C
で指定される。GetCharABCWidths 関数が文字に対して負の A または C
幅を返す場合、その文字はアンダーハングまたはオーバーハングを含んでいる。ABC
幅をフォントデザイン単位に変換するには、OUTLINETEXTMETRIC 構造体の otmEMSquare
メンバに格納されている値を使用すべきである。この値は GetOutlineTextMetrics
関数で取得できる。現在選択されているフォントの範囲外の文字にはデフォルト文字の ABC 幅が使用される。非 TrueType
フォントの文字幅を取得するには GetCharWidth 関数を使用すべきである。
> [!NOTE] > wingdi.h ヘッダは GetCharABCWidths をエイリアスとして定義しており、UNICODE
プリプロセッサ定数の有無に応じてこの関数の ANSI 版または Unicode
版が自動的に選択される。エンコーディング中立なエイリアスと非中立コードを混在させると、コンパイルまたは実行時エラーの原因となる不整合を引き起こすことがある。詳細は
[関数プロトタイプの規則](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報