FillConsoleOutputAttribute

スクリーンバッファ内の指定された座標から始まる、指定された数の文字セルに対して文字属性を設定する。

FillConsoleOutputAttribute hConsoleOutput, wAttribute, nLength, dwWriteCoord, lpNumberOfAttrsWritten

hConsoleOutput : [intptr] コンソールスクリーンバッファへのハンドル。ハンドルは **GENERIC\_WRITE** アクセス権を持っていなければならない。詳細は [Console Buffer Security and Access Rights](console-buffer-security-and-access-rights.md) を参照。
wAttribute : [int] コンソールスクリーンバッファへ書き込む際に使用する属性。詳細は [Character Attributes](console-screen-buffers.md#character-attributes) を参照。
nLength : [int] 指定された色属性に設定する文字セル数。
dwWriteCoord : [var] 属性を設定する最初のセルの文字座標を指定する [**COORD**](coord-str.md) 構造体。
lpNumberOfAttrsWritten : [var] 実際に属性が設定された文字セル数を受け取る変数へのポインタ。

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

解説

スクリーンバッファ内の指定された座標から始まる、指定された数の文字セルに対して文字属性を設定する。

[戻り値]
関数が成功した場合、戻り値は 0 以外である。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには
[**GetLastError**](/windows/win32/api/errhandlingapi/nf-errhandlingapi-getlasterror)
を呼ぶ。

[備考]

属性を設定する文字セル数がコンソールスクリーンバッファ内の指定された行の終わりを越える場合、次の行のセルが設定される。書き込むセル数がコンソールスクリーンバッファの終わりを越える場合、コンソールスクリーンバッファの終わりまでセルが書き込まれる。書き込まれた位置の文字値は変更されない。>
[!TIP] > この API は推奨されず、特定の
**[仮想ターミナル](console-virtual-terminal-sequences.md)**
に対応する機能はない。表示可能なウィンドウの外側の領域を埋めることはサポートされず、ターミナルの履歴空間用に予約されている。表示可能な領域を新しいテキストや色で埋めるには、**[カーソルを移動](console-virtual-terminal-sequences.md#cursor-positioning)**
し、**[新しい属性を設定](console-virtual-terminal-sequences.md#text-formatting)**
して、その領域に必要なテキストを書き込み、必要に応じて埋める実行のために文字を繰り返す。矩形領域を埋めるには、追加のカーソル移動とそれに続くテキストの書き込みが必要となることがある。クライアントアプリケーションは画面上にあるものを自身のメモリ内で保持することが期待され、リモート状態を問い合わせることはできない。詳細は
**[classic console versus virtual terminal](classic-vs-vt.md)**
ドキュメントを参照。

情報