【C语言】控制台窗口图形界面编程（八）：键盘事件

00. 目录

01. INPUT_RECORD结构

描述控制台输入缓冲区中的输入事件。可以使用ReadConsoleInput或PeekConsoleInput函数从输入缓冲区读取这些记录，也可以使用WriteConsoleInput函数将这些记录写入输入缓冲区。

类型声明:

typedef struct _INPUT_RECORD {
  WORD  EventType;
  union {
    KEY_EVENT_RECORD          KeyEvent;
    MOUSE_EVENT_RECORD        MouseEvent;
    WINDOW_BUFFER_SIZE_RECORD WindowBufferSizeEvent;
    MENU_EVENT_RECORD         MenuEvent;
    FOCUS_EVENT_RECORD        FocusEvent;
  } Event;
} INPUT_RECORD;

EventType

输入事件类型的句柄和存储在Event成员中的事件记录。

该成员可以是以下值之一。

事件
事件信息。此成员的格式取决于EventType成员指定的事件类型。

02. KEY_EVENT_RECORD结构

描述控制台INPUT_RECORD结构中的键盘输入事件。

typedef struct _KEY_EVENT_RECORD {
  BOOL  bKeyDown;
  WORD  wRepeatCount;
  WORD  wVirtualKeyCode;
  WORD  wVirtualScanCode;
  union {
    WCHAR UnicodeChar;
    CHAR  AsciiChar;
  } uChar;
  DWORD dwControlKeyState;
} KEY_EVENT_RECORD;

bKeyDown
如果按下该键，则该成员为TRUE。否则，此成员为FALSE（密钥已释放）。

wRepeatCount
重复计数，表示正在按住某个键。例如，当按下某个键时，您可能会获得五个事件，该成员等于1，一个事件的成员等于5，或者此成员的多个事件大于或等于1。

wVirtualKeyCode
虚拟键码识别在设备无关的方式给定的键。

wVirtualScanCode
给定键的虚拟扫描代码，表示键盘硬件生成的与设备相关的值。

uChar
以下成员的联盟。

UnicodeChar
翻译的Unicode字符。

AsciiChar
翻译的ASCII字符。

dwControlKeyState
控制键的状态。该成员可以是以下一个或多个值。

虚拟键值码表

下表显示了系统使用的虚拟键代码的符号常量名称，十六进制值以及鼠标或键盘等效项。代码按数字顺序列出。

官方参考手册: https://docs.microsoft.com/en-us/windows/desktop/inputdev/virtual-key-codes

03. ReadConsoleInput函数

从控制台输入缓冲区读取数据并将其从缓冲区中删除。

函数声明:

BOOL WINAPI ReadConsoleInput(
  _In_  HANDLE        hConsoleInput,
  _Out_ PINPUT_RECORD lpBuffer,
  _In_  DWORD         nLength,
  _Out_ LPDWORD       lpNumberOfEventsRead
);
功能:
	从控制台输入缓冲区读取数据并将其从缓冲区中删除。
参数:
	hConsoleInput 控制台输入缓冲区的句柄。句柄必须具有GENERIC_READ访问权限。
	lpBuffer 指向接收输入缓冲区数据的INPUT_RECORD结构数组的指针。
	nLength 数组元素中lpBuffer参数 指向的数组大小。
	lpNumberOfEventsRead 指向接收读取的输入记录数的变量的指针。
	
返回值:
	如果函数成功，则返回值为非零值。
	如果函数失败，则返回值为零。要获取扩展错误信息，请调用GetLastError。

官方参考网址:https://docs.microsoft.com/en-us/windows/console/readconsoleinput

04. 示例程序

示例程序一：

用户按下ESC键，则终端输出ESC

#define _CRT_SECURE_NO_WARNINGS

#include<stdio.h>
#include<string.h>
#include<stdlib.h>

#include <Windows.h>
#include <conio.h>


int main(void)
{
	//定义句柄变量
	HANDLE hOut = NULL;
	HANDLE hIn = NULL;

	//定义输入事件结构体
	INPUT_RECORD keyRecord;

	//用于存储读取记录
	DWORD res;



	//获取标准输出句柄
	hOut = GetStdHandle(STD_OUTPUT_HANDLE);

	//获取标准输入句柄
	hIn = GetStdHandle(STD_INPUT_HANDLE);
	
	while (1)
	{
		//读取输入事件
		ReadConsoleInput(hIn, &keyRecord, 1, &res);

		

		//如果当前事件是键盘事件
		if (keyRecord.EventType == KEY_EVENT)
		{
			//单击鼠标左键
			if (keyRecord.Event.KeyEvent.wVirtualKeyCode == VK_ESCAPE)
			{
				printf("用户按下了ESC键");
			}

		}
	}

	//关闭句柄
	CloseHandle(hOut);
	CloseHandle(hIn);

	//system("pause");
	getchar();
	return 0;
}

在上面的样例程序中，当你按下Esc键后又马上释放，程序会输出两次Esc，因为有两次事件的虚拟键代码都是Esc键的代码，一次是按下，一次是释放。如果要实现按下键后出现反应，释放不出现反应。

代码优化如下:

		//如果当前事件是键盘事件
		if (keyRecord.EventType == KEY_EVENT)
		{
			//单击按键左键  如果是按下就输出， 如果是释放就不输出
			if (keyRecord.Event.KeyEvent.wVirtualKeyCode == VK_ESCAPE
				&& keyRecord.Event.KeyEvent.bKeyDown == 1)
			{
				printf("用户按下了ESC键");
			}

		}

示例程序二：

#define _CRT_SECURE_NO_WARNINGS

#include<stdio.h>
#include<string.h>
#include<stdlib.h>

#include <Windows.h>
#include <conio.h>


int main(void)
{
	//定义句柄变量
	HANDLE hOut = NULL;
	HANDLE hIn = NULL;

	//定义输入事件结构体
	INPUT_RECORD keyRecord;

	//用于存储读取记录
	DWORD res;



	//获取标准输出句柄
	hOut = GetStdHandle(STD_OUTPUT_HANDLE);

	//获取标准输入句柄
	hIn = GetStdHandle(STD_INPUT_HANDLE);
	
	while (1)
	{
		//读取输入事件
		ReadConsoleInput(hIn, &keyRecord, 1, &res);

		

		//如果当前事件是键盘事件
		if (keyRecord.EventType == KEY_EVENT)
		{
			//单击按键左键  如果是按下就输出， 如果是释放就不输出
			if (keyRecord.Event.KeyEvent.wVirtualKeyCode == 'B'
				&& keyRecord.Event.KeyEvent.bKeyDown == 1)
			{
				if (keyRecord.Event.KeyEvent.dwControlKeyState & CAPSLOCK_ON)
				{
					printf("B");
				}
				else
				{
					printf("b");
				}
			}
		}
	}

	//关闭句柄
	CloseHandle(hOut);
	CloseHandle(hIn);

	//system("pause");
	getchar();
	return 0;
}

【注意】

各个控制键状态的的确定并不是使用等于符号==而是按位与&运算符，因为在同一时刻可能有多种控制键状态值，比如各种锁定都被打开且各种控制键也被同时按下。因为使用位操作，方便查询各个控制键的状态而不使之出现冲突。

最后

以上就是欣慰月亮为你收集整理的【C语言】控制台窗口图形界面编程（八）：键盘事件的全部内容，希望文章能够帮你解决【C语言】控制台窗口图形界面编程（八）：键盘事件所遇到的程序开发问题。

如果觉得靠谱客网站的内容还不错，欢迎将靠谱客网站推荐给程序员好友。