SetConsoleCursorPosition函数的用法

SetConsoleCursorPosition是Windows API中的一个函数，用于设置控制台屏幕缓冲区中光标的位置。在使用前要引入头文件#include<conio.h> #include<Windows.h>

函数原型

BOOL WINAPI SetConsoleCursorPosition(
  _In_ HANDLE hConsoleOutput,
  _In_ COORD  dwCursorPosition
);

参数说明

• hConsoleOutput: 控制台输出句柄，通常通过 GetStdHandle(STD_OUTPUT_HANDLE) 获取

• dwCursorPosition: 一个 COORD 结构体，指定新的光标位置（X 和 Y 坐标）

coord结构体

typedef struct _COORD {
    SHORT X;
    SHORT Y;
} COORD;

• X: 列坐标（水平位置），从 0 开始

• Y: 行坐标（垂直位置），从 0 开始

返回值

• 成功：返回非零值

• 失败：返回零，可通过 GetLastError() 获取错误信息

C语言示例

#include <windows.h>
#include <stdio.h>

int main() {
    HANDLE hConsole = GetStdHandle(STD_OUTPUT_HANDLE);
    COORD position = {20, 3};  // 第3行第20列
    
    if (SetConsoleCursorPosition(hConsole, position)) {
        printf("Hello from position (20, 3)!\n");
    } else {
        printf("Failed to set cursor position\n");
    }
    
    return 0;
}

注意事项

1. 坐标系统: 控制台坐标从 (0,0) 开始，表示左上角

2. 缓冲区大小: 确保坐标值不超过控制台缓冲区的大小

3. 错误处理: 总是检查函数返回值以确保操作成功

4. 句柄权限: 确保拥有对控制台输出的适当访问权限

常见应用场景

• 创建文本用户界面 (TUI)

• 游戏开发中的控制台游戏

• 进度条和动态显示

• 格式化输出和报表生成