控制台API函数----HANDLE、SetConsoleCursorPosition、SetConsoleTextAttribute
控制台API函数
调用相关文本界面控制的API函数，这些函数可分为三类。
一、用于控制台窗口控制的函数(包括窗口的缓冲区大小、窗口前景字符和背景颜色、窗口标题、大小和位置等)；
二、用于控制台输入输出的函数(包括字符属性操作函数)；
三、其他的函数并为最后一类。
（注意：当不需要使用句柄时需要调用CloseHandle()来关闭输入输出句柄，就像malloc申请的内存空间最后需要用free函数释放掉一样，后面会介绍CloseHandle的具体使用方法）
可以理解为句柄就是一种资源，就像内存一样，用完就得释放，一个程序创建的句柄数是有限制的，时间如果比较短可能看不出来什么问题，时间一旦长了，可能就会导致程序无法继续创建句柄（意思是系统的句柄资源用光了）
控制台窗口控制API函数（部分）
GetConsoleScreenBufferInfo 获取控制台窗口信息
GetConsoleTitle 获取控制台窗口标题
ScrollConsoleScreenBuffer 在缓冲区中移动数据块（更改指定缓冲区大小）
SetConsoleScreenBufferSize 更改指定缓冲区大小
SetConsoleTitle 设置控制台窗口标题
SetConsoleWindowInfo 设置控制台窗口信息
（函数前半部分很相似SetConsole（设置控制台）、GetConsole（获取控制台），只需要记后面就方便多了）
在程序中还必须包含头文件windows.h
1、HANDLE
本篇随笔主要内容是各个函数的使用，想了解句柄HANDLE的读者可以先看下这篇文章：深入了解Windows句柄到底是什么
HANDLE在WindNT.h中的声明为
typedef void *HANDLE;
从上面可以看出HANDLE是一种无类型指针，句柄是处理对象的一个接口，你可以通过句柄去操作程序中所涉及的对象。在windows中，句柄是和对象一一对应的32位无符号整数值，对象可以映射到唯一的句柄，
句柄也可以映射到唯一的对象windows需要向程序员提供必要地编程接口，在这些接口中，允许程序员访问，创建和销毁对象，但是，出于封装的考虑，windows并不想向程序员返回指针
如果作数据的话，句柄这种方式则允许你按自己的方式直接操作数据，但windows又不向你直接暴露数据。直接操作数据是程序员需要的，不暴露数据是windows所需要的，句柄封装方式实现了各取所需。
（很好的找到了满足双方需且的平衡点）
“句柄”是Windows最常用的概念。它通常用来标识Windows资源(如菜单、图标、窗口等)和设备等对象。虽然可以把句柄理解为是一个指针变量类型，但它不是对象所在的地址指针，而是作为Windows系统内部表的索引值来使用的。
代码示例：
HANDLE hOut;
2、GetStdHandle函数
函数功能：获取指定的标准设备的句柄，使用GetStdHandle需要一个参数，参数的取值有三种
STD_INPUT_HANDLE----标准输入句柄
STD_OUTPUT_HANDLE----标准输出句柄
STD_ERROR_HANDLE----标准错误句柄
先回顾一下文件操作中输入输出重定向的概念
在默认情况下：
标准输入（stdin）----键盘
标准输出（stdout）----显示器（屏幕）
标准错误（stderr）----显示器（屏幕）
（注意：标准输出句柄和标准错误句柄默认情况下都是对应的屏幕）
代码示例：
HANDLE hOut;
hOut = GetStdHandle(STD_OUTPUT_HANDLE); /* 获取标注输出句柄 */
HANDLE hOut可理解为：定义了一个变量名为hOut的变量，变量的类型为HANDLE（句柄）类型
3、COORD
COORD是Windows API中定义的一种结构，表示一个字符在控制台屏幕上的坐标。其在头文件WinCon.h中的定义为：
1 typedef struct _COORD {
2 SHORT X;
3 SHORT Y;
4 } COORD, *PCOORD;
从上面可以看出 COORD是一个结构体类型，结构体里面有两个短整形变量X、Y，用来表示光标的坐标
（注意：X是横坐标（horizontal coordinate），Y是纵坐标（vertical coordinate）不要与二维数组的坐标表示搞混了，二维数组第一维是纵坐标，第二维是横坐标）
代码示例：
COORD pos = {x, y};/* x是横坐标 y是纵坐标 */
4、CONSOLE_CURSOR_INFO
控制台光标信息，先去WinCon.h里面去瞧一瞧声明是什么样子的
typedef struct _CONSOLE_CURSOR_INFO {
DWORD dwSize;
BOOL bVisible;
} CONSOLE_CURSOR_INFO, *PCONSOLE_CURSOR_INFO;
从上面可以看出，CONSOLE_CURSOR_INFO是一个结构体，结构体里面有两个成员一个是dwSize表示光标的大小（取值范围1~100），第二个是成员是bVisible表示光标是否可见（（TRUE）可见，（FALSE）不可见）
5、SetConsoleCursorInfo函数
函数功能：设置控制台光标信息，使用这个函数需要两个参数，第一个参数的类型HADNLE，第二个参数的类型CONSOLE_CURSOR_INFO *类型
代码示例：
1 #include <stdio.h>
2 #include <windows.h>
3
4 void ConsoleCursor ();
5
6 int main()
7 {
8
9
10 return 0;
11 }
12
13 void ConsoleCursor ()
14 {
15 HANDLE hOut;
16 CONSOLE_CURSOR_INFO cur; /* 定义了一个结构体变量 cur*/
17
18 cur.dwSize = 100; /* 光标大小设置为100 */
19 hOut = GetStdHandle(STD_OUTPUT_HANDLE); /* 获取标注输出句柄 */
20 SetConsoleCursorInfo(hOut, &cur); /* 设置控制台光标信息 */
21 }
上面的代码中，ConsoleCursor这个函数中没有设置光标是否可见（默认为可见），读者如果想设置为光标不可见将bVisible赋值为0就可以了（0（光标不可见）、非0（光标可见））
（注意：dwSize的取值范围是1~100，如果赋值的大小超过100则参数失效，光标大小为默认大小）
运行效果图：
在设置光标不可见时发现了一个有趣的现象，如果只把光标设置为不可见cur.bVisible = 0，而不对光标的大小赋值的话，用SetConsoleCursorInfo是不起作用的
代码如下：
1 #include <stdio.h>
2 #include <windows.h>
3
4 void ConsoleCursor ();
5
6 int main()
7 {
8 printf("***");
9 ConsoleCursor();
10 return 0;
11 }
12
13 void ConsoleCursor ()
14 {
15 HANDLE hOut;
16 CONSOLE_CURSOR_INFO cur; /* 定义了一个结构体变量 cur*/
17
18 //cur.dwSize = 100; /* 光标大小设置为100 */
19 cur.bVisible = 0; /* 光标设置为不可见 */
20 hOut = GetStdHandle(STD_OUTPUT_HANDLE); /* 获取标注输出句柄 */
21 SetConsoleCursorInfo(hOut, &cur); /* 设置控制台光标信息 */
22 }
运行效果如下：
光标并没有隐藏，想要隐藏光标需要给光标大小cur.dwSize赋值，赋值范围1~100（如果赋值大小超过1~100，那么赋值无效，光标还是无法隐藏---这也算个坑了 要注意一下）
给cur赋初值也可这样写
CONSOLE_CURSOR_INFO cur = {1, 0};
6、SetConsoleCursorPosition函数
SetConsoleCursorPosition这个函数的功能是：设置控制台光标坐标（Set--设置、Console--控制台、Cursor--光标、Position--坐标，还算蛮好记的），使用这个函数需要两个参数：第一个参数类型为HANDLE，第二个参数类型为COORD
代码示例：
1 #include <stdio.h>
2 #include <windows.h>
3
4 void gotoxy(int x, int y);
5 void ConsoleCursor ();
6
7 int main()
8 {
9 printf("***");
10 gotoxy(0,5);
11 printf("***");
12
13 return 0;
14 }
15
16 void gotoxy(int x, int y)
17 {
18 COORD pos = {x, y};/* x是横坐标 y是纵坐标 */
19 HANDLE hOut;
20
21 hOut = GetStdHandle(STD_OUTPUT_HANDLE); /* 获取标注输出句柄 */
22 SetConsoleCursorPosition(hOut,pos); /* 设置控制台光标坐标(设备句柄, 光标坐标) */
23 }
运行效果图：
7、CONSOLE_SCREEN_BUFFER_INFO
控制台窗口缓冲区信息，先到WinCon.h头文件中瞧一下声明部分
typedef struct _CONSOLE_SCREEN_BUFFER_INFO {
COORD dwSize;
COORD dwCursorPosition;
WORD wAttributes;
SMALL_RECT srWindow;
COORD dwMaximumWindowSize;
} CONSOLE_SCREEN_BUFFER_INFO, *PCONSOLE_SCREEN_BUFFER_INFO;
这个比上面CONSOLE_CURSOR_INFO（控制台光标信息）的成员多了一些，一个一个成员来看
第一个成员：
COORD dwSize;
dwSize缓冲区的宽度X和高度Y
第二个成员：
COORD dwCursorPosition;
dwCursorPosition当前光标在缓冲区中的坐标
第三个成员：
WORD wAttributes;
wAttributes文本的属性（前景色、背景色等信息）
第四个成员：
SMALL_RECT srWindow;
srWindow当前窗口显示的大小和位置
第五个成员：
COORD dwMaximumWindowSize;
dwMaximumWindowSize最大的窗口缓冲区大小
8、GetConsoleScreenBufferInfo函数
函数功能：获取控制台窗口缓冲区信息，使用这个函数需要两个参数，第一个参数HANDLE类型，第二参数CONSOLE_SCREEN_BUFFER_INFO*类型
使用这个函数就可以得到控制台缓冲区的一些有意思的信息了，下面来看一下可以得到哪些参数
代码示例：
#include <stdio.h>
#include <windows.h>
void TextAttribute(); /* 设置前景色、后景色、获取控制台信息 */
int main()
{
printf("***");
TextAttribute();
return 0;
}
/* Function: 设置前景色后景色和获取控制台信息 */
void TextAttribute ()
{
HANDLE hOut;
CONSOLE_SCREEN_BUFFER_INFO scr;
hOut = GetStdHandle(STD_OUTPUT_HANDLE); /* 获取标准输出句柄 */
GetConsoleScreenBufferInfo(hOut, &scr);
printf("当前光标：\n横坐标=%d 纵坐标=%d\n", scr.dwCursorPosition.X, scr.dwCursorPosition.Y);
printf("缓冲区最大：宽=%d，高=%d\n",scr.dwMaximumWindowSize.X, scr.dwMaximumWindowSize.Y);
printf("缓冲区 宽=%d 高=%d\n",scr.dwSize.X, scr.dwSize.Y);
printf("底部=%d 顶部=%d 左=%d 右=%d", scr.srWindow.Bottom, scr.srWindow.Top, scr.srWindow.Left, scr.srWindow.Right);
printf("",scr.wAttributes);
SetConsoleTextAttribute(hOut, FOREGROUND_BLUE); /* 设置控制台颜色，前景色为蓝色*/
SetConsoleTextAttribute(hOut, BACKGROUND_RED); /* 背景色为红色 */
}
运行结果：
关于上面这些参数可以在控制台的默认值里面找到对应的值
（底部和右的值需要在窗口最大的宽度下-1，这里跟数组的下标有点相似，窗口大小也是从0开始的）
9、SetConsoleTextAttribute函数
SetConsoleTextAttribute这个函数的功能是：设置控制台文本属性（颜色），可以设置前景色FOREGROUND（文本颜色）和背景色BACKGROUND（看厌了DOS控制台的黑白色，终于可以换个颜色了(┬＿┬)）
使用SetConsoleTextAttribute需要两个参数（句柄, 属性），第二个参数没写成颜色是因为SetConsoleTextAttribute还可以高亮显示，现在我们去WinCon.h头文件里面去瞧一瞧，看看第二个参数有哪些是可以用的
#define FOREGROUND_BLUE 0x0001 // text color contains blue.
#define FOREGROUND_GREEN 0x0002 // text color contains green.
#define FOREGROUND_RED 0x0004 // text color contains red.
#define FOREGROUND_INTENSITY 0x0008 // text color is intensified.
#define BACKGROUND_BLUE 0x0010 // background color contains blue.
#define BACKGROUND_GREEN 0x0020 // background color contains green.
#define BACKGROUND_RED 0x0040 // background color contains red.
#define BACKGROUND_INTENSITY 0x0080 // background color is intensified.
#define COMMON_LVB_LEADING_BYTE 0x0100 // Leading Byte of DBCS
#define COMMON_LVB_TRAILING_BYTE 0x0200 // Trailing Byte of DBCS
#define COMMON_LVB_GRID_HORIZONTAL 0x0400 // DBCS: Grid attribute: top horizontal.
#define COMMON_LVB_GRID_LVERTICAL 0x0800 // DBCS: Grid attribute: left vertical.
#define COMMON_LVB_GRID_RVERTICAL 0x1000 // DBCS: Grid attribute: right vertical.
#define COMMON_LVB_REVERSE_VIDEO 0x4000 // DBCS: Reverse fore/back ground attribute.
#define COMMON_LVB_UNDERSCORE 0x8000 // DBCS: Underscore.
从上面的代码中可以看出前景色FOREGROUND和后景色BACKGROUND都只提供了三原色（红RED、绿GREEN、蓝BLUE）和颜色加强，后面的7个参数这里不再详述
代码示例：
1 #include <stdio.h>
2 #include <windows.h>
3
4 void gotoxy(int x, int y);
5 void ConsoleCursor ();
6 void TextAttribute();
7
8 int main()
9 {
10 printf("***\n");
11 TextAttribute();
12 printf("***");
13
14 return 0;
15 }
16
17 void TextAttribute ()
18 {
19 HANDLE hOut;
20
21 hOut = GetStdHandle(STD_OUTPUT_HANDLE); /* 获取标注输出句柄 */
22 SetConsoleTextAttribute(hOut, FOREGROUND_BLUE); /* 设置控制台颜色，前景色为蓝色*/
23 SetConsoleTextAttribute(hOut, BACKGROUND_RED); /* 背景色为红色 */
24 }
运行效果
也可在SetConsoleTextAttribute中同时设置前景色和后景色，代码如下，效果和上图相同
SetConsoleTextAttribute(hOut, FOREGROUND_BLUE|BACKGROUND_RED); /* 设置控制台颜色，前景色为蓝色，背景色为红色*/
10、GetConsoleTitle函数和GetConsoleTitleA函数
GetConsoleTitle函数功能是：获取控制台标题，使用这个函数需要两个参数，第一个是LTSPR类型，第二个是DWORD类型
GetConsoleTitleA函数功能和上面相同，使用时参数有点区别，第一个是LPSTR类型，第二个是DWORD类型
代码示例：
1 #include <stdio.h>
2 #include <windows.h>
3
4 void ConsoleTitle(); /* 获取控制台标题 */
5 int main()
6 {
7 ConsoleTitle();
8 return 0;
9 }
10
11 /* Function: 获取控制台标题 */
12 void ConsoleTitle()
13 {
14 char Title[200];
15
16 SetConsoleTitleA("My title");
17 GetConsoleTitleA(Title,200);
18 puts(Title);
19 }
运行效果：
11、CloseHandle函数
这个函数和fclose很相似这里就不再赘述了
