CONSOLE_CURSOR_INFO cursor

### 关于 `CONSOLE_CURSOR_INFO` 结构体

在 Windows 控制台应用程序中，`CONSOLE_CURSOR_INFO` 结构体用于存储有关控制台光标的显示信息。该结构体定义如下：

typedef struct _CONSOLE_CURSOR_INFO {
  DWORD dwSize;
  BOOL  bVisible;
} CONSOLE_CURSOR_INFO, *PCONSOLE_CURSOR_INFO;

- `dwSize`: 表示光标的尺寸占整个字符单元高度的百分比[^1]。
- `bVisible`: 是一个布尔值，指示光标是否可见。如果设置为 TRUE，则光标可见；如果设置为 FALSE，则光标不可见。

为了操作这个结构体，通常会配合两个重要的 API 函数一起使用：`GetConsoleCursorInfo` 和 `SetConsoleCursorInfo`。前者用来检索当前控制台上光标的外观属性并填充给定的 `CONSOLE_CURSOR_INFO` 结构体变量；后者则是根据所提供的参数来修改这些属性[^3]。

#### 示例代码展示如何获取和更改光标状态

下面是一段简单的 C++ 程序片段，展示了怎样通过上述提到的方法来取得现有光标配置以及改变其能见度：

#include <windows.h>
#include <iostream>

int main() {
    HANDLE hOut = GetStdHandle(STD_OUTPUT_HANDLE);
    
    // 创建一个 CONSOLE_CURSOR_INFO 对象以保存现有的光标信息
    CONSOLE_CURSOR_INFO originalCursor;

    // 调用 GetConsoleCursorInfo 来填写原始光标数据
    if (!GetConsoleCursorInfo(hOut, &originalCursor)) {
        std::cerr << "无法获取光标信息。\n";
        return GetLastError();
    }

    // 打印初始光标大小和可见性
    std::cout << "Original Cursor Size: " << originalCursor.dwSize 
              << "%\nVisibility: " << (originalCursor.bVisible ? "Visible" : "Hidden") << "\n";

    // 修改光标可见性和/或大小
    CONSOLE_CURSOR_INFO newCursor = {25, false}; // 设置新的光标大小为25%，并且隐藏它
    
    if (!SetConsoleCursorInfo(hOut, &newCursor)) {
        std::cerr << "无法设置光标信息。\n";
        return GetLastError();
    }
    
    system("pause"); // 暂停以便观察效果变化后再恢复原状

    // 将光标重置回原来的样式
    SetConsoleCursorInfo(hOut, &originalCursor);

    return 0;
}

这段程序首先获得了标准输出设备的标准句柄，并利用 `GetConsoleCursorInfo()` 方法读取了当前光标的尺寸与可见性的设定。接着打印出了这些信息供用户查看。之后创建了一个具有不同特性的新 `CONSOLE_CURSOR_INFO` 实例，并调用了 `SetConsoleCursorInfo()` 应用这一变更。最后，在暂停一段时间让用户能够看到实际的变化后，又把光标的状态还原到了最开始的样子。