KeyCode

概览

字段	值
Kind	Enum · 枚举 Enum
Realm	common

• Inherit: Int
• 继承链: Int → KeyCode

KeyCode 枚举用于标识键盘按键与鼠标按键，取值覆盖字母键、数字键、方向键、功能键、修饰键以及鼠标按键等。它将物理按键抽象为可比较的枚举成员，方便在输入事件回调与按键状态查询中判断用户操作的是哪一个键。

适用场景

常见于使用 UserInputService 的输入处理逻辑中，例如在 InputBegan 回调内判断 inputObject.KeyCode 是否为某个键来触发技能或动作；也可用 IsKeyDown 持续检测某个按键是否处于按下状态。

使用要点

通过 Enums.KeyCode 中的具体枚举项 形式引用具体按键，例如 Enums.KeyCode.A、Enums.KeyCode.Space、Enums.KeyCode.F1。在 InputBegan 连接的回调中先检查 inputObject.UserInputType 是否为 Enums.UserInputType.Keyboard，再用 inputObject.KeyCode 与目标枚举成员比较；也可把枚举值传给 UserInputService:IsKeyDown 或与 GetKeysPressed 的结果配合判断按键状态。

注意事项

引用时必须写完整的 Enums.KeyCode 前缀，禁止用数字或其他命名空间代替。KeyCode 只作为枚举值参与比较与传参，不能通过构造方法创建实例。比较按键前建议先用 UserInputType 区分键盘与鼠标输入，避免混淆不同来源的 KeyCode。

枚举值

值	名称	说明
1	MouseLeft	鼠标左键。
2	MouseRight	鼠标右键。
4	MouseMiddle	鼠标中键。
8	Backspace	退格键。
9	Tab	Tab 制表键。
13	Return	回车键。
16	Shift	通用 Shift 修饰键。
160	LeftShift	左 Shift 键。
161	RightShift	右 Shift 键。
17	Ctrl	通用 Ctrl 修饰键。
162	LeftControl	左 Ctrl 键。
163	RightControl	右 Ctrl 键。
18	Alt	通用 Alt 修饰键。
164	LeftAlt	左 Alt 键。
165	RightAlt	右 Alt 键。
20	CapsLock	大小写锁定键。
27	Escape	Esc 取消键。
32	Space	空格键。
33	PageUp	向上翻页键。
34	PageDown	向下翻页键。
35	End	End 行尾键。
36	Home	Home 行首键。
37	Left	左方向键。
38	Up	上方向键。
39	Right	右方向键。
40	Down	下方向键。
44	Print	截图/打印屏幕键。
45	Insert	插入键。
46	Delete	删除键。
187	Equals	主键盘等号或加号键。
189	Minus	主键盘减号或下划线键。
144	NumLock	数字小键盘锁定键。
96	KeypadZero	数字小键盘 0 键。
97	KeypadOne	数字小键盘 1 键。
98	KeypadTwo	数字小键盘 2 键。
99	KeypadThree	数字小键盘 3 键。
100	KeypadFour	数字小键盘 4 键。
101	KeypadFive	数字小键盘 5 键。
102	KeypadSix	数字小键盘 6 键。
103	KeypadSeven	数字小键盘 7 键。
104	KeypadEight	数字小键盘 8 键。
105	KeypadNine	数字小键盘 9 键。
106	KeypadMultiply	数字小键盘乘号键。
107	KeypadPlus	数字小键盘加号键。
109	KeypadMinus	数字小键盘减号键。
110	KeypadPeriod	数字小键盘小数点键。
111	KeypadDivide	数字小键盘除号键。
48	Zero	主键盘数字 0 键。
49	One	主键盘数字 1 键。
50	Two	主键盘数字 2 键。
51	Three	主键盘数字 3 键。
52	Four	主键盘数字 4 键。
53	Five	主键盘数字 5 键。
54	Six	主键盘数字 6 键。
55	Seven	主键盘数字 7 键。
56	Eight	主键盘数字 8 键。
57	Nine	主键盘数字 9 键。
65	A	字母 A 键。
66	B	字母 B 键。
67	C	字母 C 键。
68	D	字母 D 键。
69	E	字母 E 键。
70	F	字母 F 键。
71	G	字母 G 键。
72	H	字母 H 键。
73	I	字母 I 键。
74	J	字母 J 键。
75	K	字母 K 键。
76	L	字母 L 键。
77	M	字母 M 键。
78	N	字母 N 键。
79	O	字母 O 键。
80	P	字母 P 键。
81	Q	字母 Q 键。
82	R	字母 R 键。
83	S	字母 S 键。
84	T	字母 T 键。
85	U	字母 U 键。
86	V	字母 V 键。
87	W	字母 W 键。
88	X	字母 X 键。
89	Y	字母 Y 键。
90	Z	字母 Z 键。
112	F1	功能键 F1。
113	F2	功能键 F2。
114	F3	功能键 F3。
115	F4	功能键 F4。
116	F5	功能键 F5。
117	F6	功能键 F6。
118	F7	功能键 F7。
119	F8	功能键 F8。
120	F9	功能键 F9。
121	F10	功能键 F10。
122	F11	功能键 F11。
123	F12	功能键 F12。