控制台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("当前光标:
横坐标=%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很相似这里就不再赘述了

原文地址:https://www.cnblogs.com/lanhaicode/p/10498497.html