控制台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("当前光标:
横坐标=%d 纵坐标=%d
", scr.dwCursorPosition.X, scr.dwCursorPosition.Y);
printf("缓冲区最大:宽=%d,高=%d
",scr.dwMaximumWindowSize.X, scr.dwMaximumWindowSize.Y);
printf("缓冲区 宽=%d 高=%d
",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("***
");
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很相似这里就不再赘述了