指定されたデバイスコンテキストのテキストの色を指定された色に設定します。

COLORREF SetTextColor(
  HDC hdc,           // デバイスコンテキストのハンドル
  COLORREF crColor   // テキストの色
);

パラメータ

hdc

デバイスコンテキストのハンドルを指定します。

crColor

テキストの色を指定します。

戻り値

関数が成功すると、以前のテキストの色が 値で返ります。

関数が失敗すると、CLR_INVALID が返ります。

Windows NT/2000：拡張エラー情報を取得するには、 関数を使います。

解説

テキストの色は、TextOut 関数と ExtTextOut 関数により文字を出力する際に文字部分の描画に使用されます。また、ビットマップをカラーからモノクロに変換したり、その逆の変換を行う場合にも使用されます。

対応情報

Windows NT/2000：Windows NT 3.1 以降
Windows 95/98：Windows 95 以降
ヘッダー：Wingdi.h で宣言、Windows.h をインクルード
インポートライブラリ：Gdi32.lib を使用

参照

ExtTextOut, GetTextColor, , SetBkColor, StretchBlt, TextOut,