WriteConsoleOutputAttribute

指定した位置から始まるコンソール画面バッファの連続セルへ、指定数の文字属性をコピーする。

WriteConsoleOutputAttribute hConsoleOutput, lpAttribute, nLength, dwWriteCoord, lpNumberOfAttrsWritten

hConsoleOutput : [intptr] コンソール画面バッファのハンドル。GENERIC_WRITE アクセス権を持つ必要がある。詳細は Console Buffer Security and Access Rights を参照。
lpAttribute : [var] コンソール画面バッファへ書き込む際に使う属性。詳細は Character Attributes を参照。
nLength : [int] 属性をコピーする画面バッファセル数。
dwWriteCoord : [var] 属性を書き込むコンソール画面バッファ内の最初のセルの文字座標を指定する COORD 構造体。
lpNumberOfAttrsWritten : [var] 実際にコンソール画面バッファに書き込まれた属性数を受け取る変数へのポインタ。

(プラグイン / モジュール : kernel32.dll)

解説

指定した位置から始まるコンソール画面バッファの連続セルへ、指定数の文字属性をコピーする。

[戻り値]
関数が成功した場合、戻り値は 0 以外である。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには
GetLastError を呼ぶ。

[備考]

書き込む属性数が指定行末を超える場合、属性は次の行に書き込まれる。属性数がコンソール画面バッファ末尾を超える場合、書き込みは画面バッファ末尾までで停止する。書き込み先の文字値は変更されない。>
[!TIP] > 本 API
はテキスト書式とカーソル位置決めのシーケンスに仮想ターミナル相当機能がある。挿入位置にカーソルを移動し、書式を適用してテキストを書き込む。テキストを伴わずに領域に色を適用する相当機能はない。

情報