FillConsoleOutputCharacterW

指定された座標から始めて、指定された回数だけコンソールスクリーンバッファに文字を書き込む。

FillConsoleOutputCharacterW hConsoleOutput, cCharacter, nLength, dwWriteCoord, lpNumberOfCharsWritten

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

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

解説

指定された座標から始めて、指定された回数だけコンソールスクリーンバッファに文字を書き込む。

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

[備考]

書き込む文字数がコンソールスクリーンバッファ内の指定された行の終わりを越える場合、次の行に文字が書き込まれる。書き込む文字数がコンソールスクリーンバッファの終わりを越える場合、コンソールスクリーンバッファの終わりまで文字が書き込まれる。書き込まれた位置の属性値は変更されない。[!INCLUDE
[setting-codepage-mode-remarks](./includes/setting-codepage-mode-remarks.md)]
> [!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)**
ドキュメントを参照。

情報