CDC::GetTextExtent

更新 : 2007 年 11 月

寸法を決定するために現在のフォントを使って、行の幅と高さを計算します。

CSize GetTextExtent(
   LPCTSTR lpszString,
   int nCount 
) const;
CSize GetTextExtent(
   const CString& str 
) const;

パラメータ

  • lpszString
    文字列へのポインタ。このパラメータには、CString オブジェクトを渡すこともできます。

  • nCount
    文字列内の文字数を指定します。

  • str
    指定した文字列を保持する CString オブジェクト。

戻り値

文字列の寸法 (論理単位) を CSize オブジェクトで返します。

解説

この情報は、属性デバイス コンテキストの m_hAttribDC から取得します。

既定で、GetTextExtent は、寸法を取得するテキストが水平線に沿って設定されていると見なします。つまり、印字方向は 0 になります。0 以外の印字方向を指定してフォントを作成する場合は、テキストの角度を明示的に変換して、文字列の寸法を取得する必要があります。

現在のクリップ領域は、GetTextExtent が返す幅と高さに影響しません。

通常のセル配列で文字を配置しない (つまり、カーニングが実行される) デバイスもあるため、文字列内の各文字の寸法の総計と文字列の寸法が一致しないことがあります。

必要条件

ヘッダー : afxwin.h

参照

参照

CDC クラス

階層図

CDC::GetTabbedTextExtent

CDC::m_hAttribDC

CDC::m_hDC

CDC::GetOutputTextExtent

CDC::SetTextJustification

CSize クラス

その他の技術情報

CDC のメンバ