指定された四角形内の文字列をフォーマットします。
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 関数が自動的に文字数を計算します。
- str
-
指定する描画文字列を保持する CString オブジェクト。
- nFormat
-
テキストのフォーマット方法。『Platform 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 と同時には指定できません。
- lpDTParams
-
追加のフォーマット オプションを指定する DRAWTEXTPARAMS 構造体へのポインタ。このパラメータには、NULL を指定できます。
フォーマットとは、タブを適切なスペースに展開したり、指定された四角形の左、右、中央にテキストを揃えたり、指定された四角形内にテキストが収まるように行を分けたりすることです。フォーマットのタイプはパラメータ nFormat および lpDTParams で指定します。詳細については、『Platform SDK』の「CDC::DrawText」および「DrawTextEx」を参照してください。
テキストの色は CDC::SetTextColor 関数で設定します。
関連項目
CDC クラス階層図
CDC::DrawText
CDC::ExtTextOut
CDC::TabbedTextOut
CDC::TextOut
DrawText
RECT 構造体
CDC::SetTextAlign