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

00. 目录

目录

• 00. 目录
• 01. INPUT_RECORD结构
• 02. KEY_EVENT_RECORD结构
• 03. ReadConsoleInput函数
• 04. 示例程序

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成员中的事件记录。

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

值	含义
FOCUS_EVENT 0x0010	该事件成员包含一个FOCUS_EVENT_RECORD结构。这些事件在内部使用，应该被忽略。
KEY_EVENT 0x0001	该事件成员包含一个KEY_EVENT_RECORD结构有关键盘事件的信息。
MENU_EVENT 0x0008	该事件成员包含一个MENU_EVENT_RECORD结构。这些事件在内部使用，应该被忽略。
MOUSE_EVENT 0x0002	所述事件构件包含MOUSE_EVENT_RECORD结构用约鼠标移动或按键按压事件的信息。
WINDOW_BUFFER_SIZE_EVENT 0x0004	该事件成员包含一个WINDOW_BUFFER_SIZE_RECORD结构有关控制台屏幕缓冲区的新大小信息。

事件
事件信息。此成员的格式取决于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
控制键的状态。该成员可以是以下一个或多个值。

值	含义
CAPSLOCK_ON 0x0080	大写锁定被打开
ENHANCED_KEY 0x0100	扩展键被按下
LEFT_ALT_PRESSED 0x0002	按下左ALT键。
LEFT_CTRL_PRESSED 0x0008	按下左CTRL键。
NUMLOCK_ON 0x0020	数字锁定被打开
RIGHT_ALT_PRESSED 0x0001	按下右ALT键。
RIGHT_CTRL_PRESSED 0x0004	按下右CTRL键。
SCROLLLOCK_ON 0x0040	滚动锁定被打开
SHIFT_PRESSED 0x0010	按下SHIFT键。

虚拟键值码表

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

恒/值	描述
VK_LBUTTON 0×01	鼠标左键
VK_RBUTTON 0×02	鼠标右键
VK_CANCEL 0×03	控制中断处理
VK_MBUTTON 0×04	鼠标中键（三键鼠标）
VK_XBUTTON1 0×05	X1鼠标按钮
VK_XBUTTON2 0×06	X2鼠标按钮
**- **0×07	未定义
VK_BACK0x08的	BACKSPACE键
VK_TAB×09	TAB键
-0x0A至0B	保留的
VK_CLEAR0x0C	清除键
VK_RETURN0X0D	回车键
-为0x0E-0F	未定义
VK_SHIFT为0x10	SHIFT键
VK_CONTROL为0x11	CTRL键
VK_MENU0×12	ALT键
VK_PAUSE0×13	暂停键
VK_CAPITAL0×14	CAPS LOCK键
-0x1A的	未定义
VK_ESCAPE0x1B	ESC键
VK_CONVERT为0x1C	IME转换
VK_NONCONVERT0x1D	IME非转换
VK_ACCEPT0X1E	IME接受
VK_MODECHANGE为0x1F	IME模式更改请求
VK_SPACE为0x20	空格键
VK_PRIOR为0x21	PAGE UP键
VK_NEXT为0x22	PAGE DOWN键
VK_END0×23	结束键
VK_HOME0X24	Home键
VK_LEFT0x25	左箭头键
VK_UP0×26	向上箭头键
VK_RIGHT0×27	右箭头键
VK_DOWN0×28	向下箭头键
VK_SELECT0x29	SELECT键
VK_PRINT0x2A	打印键
VK_EXECUTE0x2B访问	执行键
VK_SNAPSHOT0x2c上	PRINT SCREEN键
VK_INSERT0x2D	INS键
VK_DELETE0x2E之间	DEL键
VK_HELP值为0x2F	帮助键
的0x30	0键
0X31	1键
0x32	2键
0x33	3键
0x34	4键
0x35	5键
0x36	6键
0×37	7键
0x38	8键
0x39	9键
-0x3A-40	未定义
的0x41	关键
的0x42	B键
0x43中	C键
0×44	D键
0×45	E键
0×46	F键
0X47	G键
0x48	H键
×49	我关键
0x4A	J键
0x4B	K键
0x4C	L键
送出0x4d	M键
0x4E	N键
0x4F	哦关键
为0x50	P键
0x51	Q键
0×52	R键
0x53	S键
0x54	T键
0x55的	U键
0x56储存	V键
的0x57	W键
将0x58	X键
0×59	Y键
0x5A	Z键
VK_LWIN0x5B	左键Windows键（自然键盘）
VK_RWIN0x5C	右键Windows键（自然键盘）
VK_APPS0x5D	应用键（自然键盘）
-0x5E	保留的
VK_SLEEP0x5F的	电脑睡眠键
VK_NUMPAD00X60	数字小键盘0键
VK_NUMPAD10x61	数字小键盘1键
VK_NUMPAD20X62	数字小键盘2键
VK_NUMPAD30x63	数字小键盘3键
VK_NUMPAD40x64	数字键盘4键
VK_NUMPAD50x65	数字键盘5键
VK_NUMPAD60x66	数字小键盘6键
VK_NUMPAD70×67	数字小键盘7键
VK_NUMPAD80x68	数字小键盘8键
VK_NUMPAD90×69	数字小键盘9键
VK_MULTIPLY的0x6A	乘以键
VK_ADD0x6B	添加密钥
VK_SEPARATOR0x6C	分隔键
VK_SUBTRACT0x6D	减去关键
VK_DECIMAL0x6E	十进制键
VK_DIVIDE0x6F	划分密钥
VK_F10x70	F1键
VK_F20x71	F2键
VK_F30x72	F3键
VK_F40x73	F4键
VK_F50x74	F5键
VK_F60x75	F6键
VK_F70x76	F7键
VK_F80x77	F8键
VK_F90x78	F9键
VK_F100x79的	F10键
VK_F110x7A	F11键
VK_F120x7B	F12键
VK_F130x7C	F13键
VK_F140x7D	F14键
VK_F15的0x7E	F15键
VK_F160x7F的	F16键
VK_F170x80的	F17键
VK_F180×81	F18键
VK_F19为0x82	F19键
VK_F200×83	F20键
VK_F21的0x84	F21键
VK_F220x85	F22键
VK_F230x86可以	F23键
VK_F2487H的	F24键
-0x88-8F	未分配
VK_NUMLOCK的0x90	NUM LOCK键
VK_SCROLL0x91	滚动锁定键
0x92-96	OEM特定
-0x97-9F	未分配
VK_LSHIFT0XA0	左SHIFT键
VK_RSHIFT0xA1	右SHIFT键
VK_LCONTROL0xA2	左控制键
VK_RCONTROL0xA3执行	右控制键
VK_LMENU0xA4	左MENU键
VK_RMENU的0xA5	右键MENU
VK_BROWSER_BACK0xA6	浏览器返回键
VK_BROWSER_FORWARD0xA7	浏览器转发键
VK_BROWSER_REFRESH0xA8	浏览器刷新键
VK_BROWSER_STOP0xA9	浏览器停止键
VK_BROWSER_SEARCH和0xAA	浏览器搜索键
VK_BROWSER_FAVORITES是0xAB	浏览器收藏夹键
VK_BROWSER_HOME0xAC	浏览器开始和主页键
VK_VOLUME_MUTE0xAD，将	音量静音键
VK_VOLUME_DOWN0xAE	降低音量键
VK_VOLUME_UP0xAF执行	提高音量键
VK_MEDIA_NEXT_TRACK0XB0	下一曲目键
VK_MEDIA_PREV_TRACK0xB1	上一曲目键
VK_MEDIA_STOP0xB2	停止媒体键
VK_MEDIA_PLAY_PAUSE0xB3	播放/暂停媒体键
VK_LAUNCH_MAIL0xB4	启动邮件密钥
VK_LAUNCH_MEDIA_SELECT0xB5执行	选择媒体键
VK_LAUNCH_APP10xB6	启动应用程序1键
VK_LAUNCH_APP20xB7	启动应用程序2密钥
-0xB8-B9	保留的
VK_OEM_10xBA	用于杂项字符; 它可以因键盘而异。 对于美国标准键盘，使用';：'键
VK_OEM_PLUS为0xBB	对于任何国家/地区，请使用“+”键
VK_OEM_COMMA0xBC	对于任何国家/地区，请使用“，”键
VK_OEM_MINUS0xBD	对于任何国家/地区，请使用“ - ”键
VK_OEM_PERIOD0xBE	对于任何国家/地区，'。' 键
VK_OEM_2为0xBF	用于杂项字符; 它可以因键盘而异。 对于美国标准键盘，'/？' 键
VK_OEM_3将0xC0	用于杂项字符; 它可以因键盘而异。 对于美国标准键盘，使用'〜'键
-0xC1-D7	保留的
-0xD8-DA	未分配
VK_OEM_4位于0xDB	用于杂项字符; 它可以因键盘而异。 对于美国标准键盘，'[{'键
VK_OEM_5的0xDC	用于杂项字符; 它可以因键盘而异。 对于美国标准键盘，' |' 键
VK_OEM_60xDD	用于杂项字符; 它可以因键盘而异。 对于美国标准键盘，使用']}'键
VK_OEM_7写0xDE	用于杂项字符; 它可以因键盘而异。 对于美国标准键盘，“单引号/双引号”键
VK_OEM_80xDF	用于杂项字符; 它可以因键盘而异。
-取0xE0	保留的
0xE1	OEM特定
VK_OEM_1020xE2	RT 102键键盘上的尖括号键或反斜杠键
0xE3-E4	OEM特定
VK_PROCESSKEY为0xE5	IME PROCESS键
0xE6	OEM特定
VK_PACKET0xE7	用于传递Unicode字符，就像它们是击键一样。VK_PACKET键是用于非键盘输入方法的32位虚拟键值的低位字。有关更多信息，请参阅KEYBDINPUT，SendInput，WM_KEYDOWN和WM_KEYUP中的备注
-0xE8	未分配
0xE9-F5	OEM特定
VK_ATTN0xF6	关键
VK_CRSEL0xF7	CrSel密钥
VK_EXSEL0xF8的	ExSel密钥
VK_EREOF0xF9	擦除EOF键
VK_PLAY0xFA回应	播放键
VK_ZOOM0xFB的才能	缩放键
VK_NONAME0xFC有	保留的
VK_PA10xFD	PA1键
VK_OEM_CLEAR0xFE的	清除键

官方参考手册: 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;
}

【注意】

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