CDC::GetOutlineTextMetrics

[アーティクル]
08/09/2011

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 関数を呼び出し、必要なサイズを取得することです。