CDC::DrawText
指定した四角形のテキストの書式を設定するには、このメンバー関数を呼び出します。追加の書式設定オプションを指定するには、CDC::DrawTextExを使用します。
virtual int DrawText(
LPCTSTR lpszString,
int nCount,
LPRECT lpRect,
UINT nFormat
);
int DrawText(
const CString& str,
LPRECT lpRect,
UINT nFormat
);
パラメーター
lpszString
描画するテキスト文字列へのポインター。nCount が 1 の場合、一つは、文字列が null で終了する必要があります。nCount
文字列に文字の数を指定します。nCount が 1 の場合、二つ lpszString は null で終わる文字列へ long ポインターであると解釈され、DrawText は文字数を自動的に計算されます。lpRect
RECT へのポインターは構造体またはテキストが書式設定される四角形を含む CRect のオブジェクト (論理座標)。str
描画される指定文字が含まれている CString のオブジェクト。nFormat
テキストの書式を設定するメソッドを指定します。これは Windows SDKで DrawText で uFormat のパラメーターで説明されている値の組み合わせです。(ビットごとの OR 演算子を使用して結合) :[!メモ]
ある uFormat のフラグの組み合わせ、渡された文字列を変更することができます。DT_END_ELLIPSIS または DT_PATH_ELLIPSIS の DT_MODIFYSTRING を使用して文字列が変更される可能性があるアサーションを CString のオーバーライドで説明します。値 DT_CALCRECT、DT_EXTERNALLEADING、DT_INTERNAL、DT_NOCLIPと DT_NOPREFIX は DT_TABSTOP の値で使用することはできません。
戻り値
関数が正常に終了した場合、テキストの高さ。
解説
このテキストを左、右、または指定した四角形の中央に配置し、行にテキストを中断適切なスペースをタブに配置して、テキストを四角形内の特定のに適合する書式化します。書式の種類は nFormatによって指定されます。
このメンバー関数は、テキストの描画にデバイス コンテキストに選択されているフォント、テキストの色と背景色を使用します。DT_NOCLIP の形式を使用しない場合、DrawText は、テキストが外部指定された四角形ではありません。しないように、テキストがクリッピング。すべての形式は DT_SINGLELINE 形式を指定しない複数の行があると仮定されます。
選択されているフォントが小さいフォントで置き換えるには、指定した四角形に高すぎる場合、DrawText のメンバー関数はありません。
DT_CALCRECT のフラグが指定されたテキストの描画に必要な幅と高さを反映するように、lpRect で指定された四角形が更新されます。
TA_UPDATECP のテキスト配置フラグが CDC::SetTextAlign (を参照) DrawText 設定されている場合、は、指定した四角形の左ではなく現在位置で、開始されたテキストを表示します。DrawText は TA_UPDATECP のフラグを設定した場合、テキストは折り返されません (つまり、DT_WORDBREAK のフラグは無効です)。
テキストの色は CDC::SetTextColorによって設定される場合があります。
必要条件
ヘッダー: afxwin.h