SetConsoleTextAttribute

Declare Function Api_SetConsoleTextAttribute& Lib "kernel32" Alias "SetConsoleTextAttribute" (ByVal hConsoleOutput&, ByVal wAttributes&)

Declare Function SetConsoleTextAttribute Lib "kernel32" (ByVal hConsoleOutput As Long, ByVal wAttributes As Long) As Long

WriteFile 関数または WriteConsole 関数でスクリーンバッファに書き込む文字、ReadFile 関数または ReadConsole 関数でエコーする文字の前景(テキスト)色属性と背景色属性を設定する。新しい設定は、新しく書き込む文字にだけ適用される

パラメータ
hConsoleOutput
    コンソールスクリーンバッファのハンドルを指定する。このハンドルには、GENERIC_READ アクセス権が必要である。
wAttributes
    前景色と背景色の新しい値を指定する。FOREGROUND_BLUE、FOREGROUND_GREEN、FOREGROUND_RED、

    FOREGROUND_INTENSITY、BACKGROUND_BLUE、BACKGROUND_GREEN、BACKGROUND_RED、

    BACKGROUND_INTENSITY を自由に組み合わせて指定することができる。たとえば、次の組み合わせを指定すると、テキストは白、

    背景は黒になる。
    FOREGROUND_RED Or FOREGROUND_GREEN Or FOREGROUND_BLUE

戻り値
    関数が成功すると、0 以外の値が返る。
    関数が失敗すると、0 が返る。拡張エラー情報を取得するには、GetLastError 関数を使う。

解説
    スクリーンバッファの現在の色属性を調べるには、GetConsoleScreenBufferInfo 関数を使う。