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

目录

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

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;
}

【注意】

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

原文地址：https://www.cnblogs.com/szitcast/p/10924434.html