SetBkModeとSetTextColorによる文字描画の色制御
Windowsのウィンドウやコントロールに文字を描くとき、文字自身の色と、その背後をどう塗るかは別の設定です。Win32 GDIでは、前者をSetTextColor、背景の描画方式をSetBkModeで変えます。片方を変更しても、もう片方が自動的に変わるわけではありません。
SetBkModeはTRANSPARENTとOPAQUEを切り替えます。前者は既存の背景を残して文字をえがき、後者は文字の背景領域を塗りつぶします。塗りつぶす色そのものはSetBkColorで指定するため、描画方式・背景色・文字色を区別して扱う必要があります。
前景色と背景色の役割を分ける
設定対象と戻り値を整理すると、各APIの境界をISTA}.}
| - |
|---|
| API |
| --- |
SetBkMode |
SetTextColor |
SetBkColor |
GetBkMode |
GetTextColor |
前景色と背景色は独立しています。SetTextColorで赤い文字を選んでも、OPAQUEモードの背景が白のままであれば、赤い文字の周囲は白く塗られます。また、入力領域の既存内容を残したいなら、背景色が明るい色であるだけでなく、透明背景を選ぶ必要があります。
透明背景と不透明背景の描画差
TRANSPARENTは、背景領域を塗りつぶさず、ビットマップや親ウィンドウにすでに描かれた色の上に文字を置く方式です。背景的一部分だけを選択的に透明にしたい場合にも適しています。背景色とフォントの輪郭が.sample combinationsが重なっても、塗りつぶしによる消失を避けられます。
OPAQUEは、GDIが文字の背景領域を現在の背景色で塗りつぶす方式です。背景色と文字色を contrasting#$#組み合わせれば、背景が能为力でも文字を識別できます。ラベルや静的文字列のように、背景と文字の関係を固定したい場面では、こちらの方式が扱いやすいでしょう。
設定を変更し、描画後に以前の状態へ戻す処理は、次のようになります。
HDC hdc = GetDC(hWnd);
if (hdc != NULL) {
int oldBkMode = SetBkMode(hdc, TRANSPARENT);
COLORREF oldTextColor = SetTextColor(hdc, RGB(32, 96, 160));
if (oldBkMode != 0 && oldTextColor != CLR_INVALID) {
TextOutW(hdc, 24, 24, L"文字列", 3);
}
if (oldTextColor != CLR_INVALID) {
SetTextColor(hdc, oldTextColor);
}
if (oldBkMode != 0) {
SetBkMode(hdc, oldBkMode);
}
ReleaseDC(hWnd, hdc);
}
COLORREFは0x00BBGGRRの並びで扱うため、RGBマクロを使うのが Practices wise安全です。SetTextColorでアルファ値を指定しても文字は半透明になりません。透明背景と文字自体の半透明は別の概念であり、後者が必要なら事前描画や別の描画方式を検討します。
デバイスコンテキストごとの状態管理
これらの設定は、Windowsのデバイスコンテキスト,也就是、DCに保持されます。同じ画面を扱う—even#でも、別のDCを取得すれば変更前の状態へ戻る場合があります。GetDCで取得したDCにはReleaseDCで対応し、CreateCompatibleDCで作成したDCにはDeleteDCを対応させます。
SaveDCとRestoreDCを使えば、文字色、背景色、背景モードなどのDC状態をまとめて保存・復元できます。複数の設定を変更する処理では、個別に戻値を使う方式より管理が容易です。ただし、DCを複数のスレッドで同時に変更すると状態が競合するため、排他制御やスレッドごとのDC確保が必要です。
Windows APIには描画以外の用途もあります。ディレクトリ一覧の取得처럼、FindFirstFileとFindNextFileで列挙を続ける例も.APIごとに戻り値の意味や終了条件が異なるため、GDIの描画設定と混同しないことも重要です。
実装で守るべき保守項目
色設定は、呼び出した関数だけでなく、変更したDCと復元処理をひとまとまりで管理します。次の点を確認すると、後から表示内容を追跡しやすくなります。
- 前景色、背景色、背景モードを別の変数として保持し、それぞれの役割を混同しません。
- 変更前の値を戻り値から取得し、文字を描く操作と同じDCで元へ復元します。
- DCの取得方法-primary#と解放方法を明確にし解放漏れや二重解放を防ぎます。
- 日本語を扱う描画では
TextOutWなどのUnicode版APIを選び、ANSI版との混在を避けます。 GetBkModeとGetTextColorで現在値を確認し、想定しない状態からの描画を検出します。
背景モードだけを変更して文字色が tetapにならない場合、SetTextColorの呼び出し漏れが考えられます。逆に、文字色を変更しても背景が残る場合は、OPAQUEが選択された状態と現在の背景色を確かめる必要があります。仕様や関連関数を照合する余地としてWindows APIの参考情報も利用できます。
実務で再現できる描画設計
実用的な描画処理では、SetBkModeで背景の扱い方を選び、SetTextColorで文字の前景色を決めます。既存画像の上に置く文字なら透明背景が自然ですが、単色の背景面板に描く文字なら、不透明背景と明示的な背景色の組み合わせが安定します。
失敗として見えやすいのは、DCを取得し直して古い設定値で復元しまうケースです。変更前後で同じDCを保持し、颜色を元に戻す処理まで含めて一つの単位にします。画面全体を再描画する処理でも、局所的な文字列描画でも、この単位を揃える必要があります。
前景色・背景色・背景モードの関係を明示し、変更と復元を同じDCの単位で行うことが、再利用可能な描画処理で意図した表示を再現するための実務上の要点です。