SetConsoleCursorPosition

指定したコンソール画面バッファのカーソル位置を設定する SetConsoleCursorPosition 関数のリファレンス情報を参照。

SetConsoleCursorPosition hConsoleOutput, dwCursorPosition

hConsoleOutput : [intptr] コンソール画面バッファへのハンドル。ハンドルには **GENERIC\_READ** アクセス権が必要である。詳細は [コンソールバッファのセキュリティとアクセス権](console-buffer-security-and-access-rights.md) を参照。
dwCursorPosition : [var] 新しいカーソル位置を文字単位で指定する [**COORD**](coord-str.md) 構造体。座標は画面バッファ内の文字セルの列と行であり、コンソール画面バッファの境界内でなければならない。

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

解説

指定したコンソール画面バッファのカーソル位置を設定する SetConsoleCursorPosition 関数のリファレンス情報を参照。

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

[備考]

カーソル位置は、[**WriteFile**](/windows/win32/api/fileapi/nf-fileapi-writefile)
または [**WriteConsole**](writeconsole.md) による書き込み、あるいは
[**ReadFile**](/windows/win32/api/fileapi/nf-fileapi-readfile) または
[**ReadConsole**](readconsole.md)
によるエコー表示が行われる位置を決定する。カーソルの現在位置を取得するには
[**GetConsoleScreenBufferInfo**](getconsolescreenbufferinfo.md)
を使用する。新しいカーソル位置がコンソール画面バッファのウィンドウ境界の外側にある場合、ウィンドウ原点がカーソルを可視にするよう変更される。>
[!TIP] > この API は
**[仮想ターミナル](console-virtual-terminal-sequences.md)** の
**[単純カーソル位置指定](console-virtual-terminal-sequences.md#simple-cursor-positioning)**
および
**[カーソル位置指定](console-virtual-terminal-sequences.md#cursor-positioning)**
セクションに相当する。改行、復帰、バックスペース、タブの制御シーケンスもカーソル位置指定に役立てることができる。

情報