CONSOLE_CURSOR

### 关于 `CONSOLE_CURSOR` 的信息

#### 控制台光标属性结构体定义
控制台光标的属性由 `CONSOLE_CURSOR_INFO` 结构体表示，该结构体包含两个成员变量用于描述光标的大小和可见性[^4]。

typedef struct _CONSOLE_CURSOR_INFO {
    DWORD dwSize;  // 光标的尺寸占整个字符单元的比例
    BOOL bVisible; // 是否显示光标
} CONSOLE_CURSOR_INFO, *PCONSOLE_CURSOR_INFO;

#### 设置控制台光标信息的方法
为了修改这些属性，可以使用 Windows API 函数 `SetConsoleCursorInfo()` 来更新当前活动窗口中的光标样式。此函数接收两个参数：一个是标准输出句柄，另一个是指向已初始化的 `CONSOLE_CURSOR_INFO` 实例的指针[^2]。

#include <windows.h>

void ModifyCursor(HANDLE hOut, bool visible, int sizePercentage) {
    CONSOLE_CURSOR_INFO cur{};
    cur.dwSize = static_cast<DWORD>(sizePercentage);
    cur.bVisible = visible;

    SetConsoleCursorInfo(hOut, &cur); /* 设置控制台光标信息 */
}

上述代码展示了如何创建一个自定义函数来调整光标的可视状态及其相对宽度。通过传递不同的布尔值给 `bVisible` 成员以及整数值到 `dwSize` 中，即可实现对光标的灵活操控[^5]。

#### 隐藏控制台光标的实例
下面是一个简单的例子，它演示了怎样完全隐藏掉命令提示符下的光标：

#include <windows.h>

void HideCursor() {
    CONSOLE_CURSOR_INFO cursor{};

    // 初始化光标信息并设定不可见
    cursor.bVisible = FALSE;
    cursor.dwSize = sizeof(cursor);

    HANDLE handle = GetStdHandle(STD_OUTPUT_HANDLE);
    SetConsoleCursorInfo(handle, &cursor);
}

int main() {
    HideCursor();
    return 0;
}

这段程序首先获取默认的标准输出设备句柄，接着构建了一个新的 `CONSOLE_CURSOR_INFO` 对象并将之设为不可见模式，最后调用了 `SetConsoleCursorInfo()` 完成实际的变化过程。