CDC::GetOutlineTextMetrics

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

TrueType フォントのメトリック情報を取得します。

UINT GetOutlineTextMetrics(
   UINT cbData,
   LPOUTLINETEXTMETRIC lpotm
) const;

パラメータ

lpotm
OUTLINETEXTMETRIC 構造体の配列へのポインタ。この値が NULL の場合、取得したメトリックデータに必要なバッファのサイズを返します。
cbData
情報が返されるバッファのサイズをバイト単位で指定します。
lpotm
OUTLINETEXTMETRIC 構造体へのポインタ。この値が NULL のときは、取得したメトリック情報に必要なバッファのサイズを返します。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

OUTLINETEXTMETRIC 構造体は、TEXTMETRIC 構造体も含めて、TrueType 形式のフォントのメトリック情報を持っています。OUTLINETEXTMETRIC 構造体の最後の 4 つのメンバは、文字列へのポインタです。アプリケーションでは、ほかのメンバに必要な領域に加えて、これらの文字列のための領域を割り当てる必要があります。文字列のサイズの制限は、システムでは規定されていないため、メモリを割り当てるための簡単な方法は、まず lpotm に NULL を設定して、GetOutlineTextMetrics 関数を呼び出し、必要なサイズを取得することです。