GetOutlineTextMetricsW

GetOutlineTextMetrics 関数は、TrueType フォントのテキストメトリックを取得する。(Unicode)

GetOutlineTextMetricsW hdc, cjCopy, potm

hdc : [intptr] デバイスコンテキストのハンドル。
cjCopy : [int] テキストメトリックを受け取る配列のサイズ(バイト単位)。
potm : [var] OUTLINETEXTMETRIC 構造体へのポインタ。このパラメータが NULL の場合、関数は取得するメトリックデータに必要なバッファサイズを返す。

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

解説

GetOutlineTextMetrics 関数は、TrueType フォントのテキストメトリックを取得する。(Unicode)

[戻り値]
関数が成功した場合、戻り値は 0 以外の値または必要なバッファサイズである。失敗した場合は 0 である。

[備考]
OUTLINETEXTMETRIC 構造体は、TrueType
フォント向けに提供されるほとんどのテキストメトリック情報(TEXTMETRIC 構造体を含む)を含む。OUTLINETEXTMETRIC
で返されるサイズは論理単位であり、現在のマッピングモードに依存する。
> [!NOTE] > wingdi.h ヘッダは GetOutlineTextMetrics
をエイリアスとして定義しており、UNICODE プリプロセッサ定数の有無に応じてこの関数の ANSI 版または Unicode
版が自動的に選択される。エンコーディング中立なエイリアスと非中立コードを混在させると、コンパイルまたは実行時エラーの原因となる不整合を引き起こすことがある。詳細は
[関数プロトタイプの規則](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報