CDC::DrawTextEx

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

更新 : 2007 年 11 月

指定された四角形内の文字列をフォーマットします。

virtual int DrawTextEx(
   LPTSTR lpszString,
   int nCount,
   LPRECT lpRect,
   UINT nFormat,
      LPDRAWTEXTPARAMS lpDTParams
);
int DrawTextEx(
   const CString& str,
   LPRECT lpRect,
   UINT nFormat,
      LPDRAWTEXTPARAMS lpDTParams
);

パラメータ

lpszString
描画する文字列へのポインタ。パラメータ nCount が -1 のときは、文字列は null 文字で終わらせてください。
nCount
文字列のバイト数。パラメータ nCount が -1 のときは、パラメータ lpszString が NULL で終わる文字列への long のポインタと解釈して、DrawText 関数が自動的に文字数を計算します。
lpRect
テキストがフォーマットされる四角形 (論理座標) を表す RECT 構造体または CRect オブジェクトへのポインタ。
str
指定する描画文字列を保持する CString オブジェクト。

nFormat
テキストのフォーマット方法。Windows SDK の「DrawText」にある uFormat パラメータの値を任意に組み合わせることができます。組み合わせにはビットごとの OR 演算子を使います。

メモ :
uFormat フラグの組み合わせ方によっては、渡した文字列が変更されます。DT_MODIFYSTRING と DT_END_ELLIPSIS または DT_PATH_ELLIPSIS を組み合わせると、文字列が変更され、CString のオーバーライドでアサートされることがあります。DT_CALCRECT、DT_EXTERNALLEADING、DT_INTERNAL、DT_NOCLIP、および DT_NOPREFIX は、DT_TABSTOP と同時には指定できません。

uFormat フラグの組み合わせ方によっては、渡した文字列が変更されます。DT_MODIFYSTRING と DT_END_ELLIPSIS または DT_PATH_ELLIPSIS を組み合わせると、文字列が変更され、CString のオーバーライドでアサートされることがあります。DT_CALCRECT、DT_EXTERNALLEADING、DT_INTERNAL、DT_NOCLIP、および DT_NOPREFIX は、DT_TABSTOP と同時には指定できません。

lpDTParams
追加のフォーマットオプションを指定する DRAWTEXTPARAMS 構造体へのポインタ。このパラメータには、NULL を指定できます。

解説

フォーマットとは、タブを適切なスペースに展開したり、指定された四角形の左、右、中央にテキストを揃えたり、指定された四角形内にテキストが収まるように行を分けたりすることです。フォーマットのタイプはパラメータ nFormat および lpDTParams で指定します。詳細については、Windows SDK の「CDC::DrawText」および「DrawTextEx」を参照してください。

テキストの色は CDC::SetTextColor 関数で設定します。