Pygame详解（七）：key 模块

pygame.key

与键盘相关的 Pygame 模块。

函数

• pygame.key.get_focused()  —  当窗口获得键盘的输入焦点时返回 True
• pygame.key.get_pressed()  —  获取键盘上所有按键的状态
• pygame.key.get_mods()  —  检测是否有组合键被按下
• pygame.key.set_mods()  —  临时设置某些组合键为被按下状态
• pygame.key.set_repeat()  —  控制重复响应持续按下按键的时间
• pygame.key.get_repeat()  —  获取重复响应按键的参数
• pygame.key.name()  —  获取按键标识符对应的名字

该模块包含处理与键盘操作相关的函数。当键盘按键被按下和释放时，事件队列将获得 pygame.KEYDOWN 和 pygame.KEYUP 事件消息。这两个消息均包含 key 属性，是一个整数的 id，代表键盘上具体的某个按键。

pygame.KYEDOWN 事件还有个额外的属性 unicode 和 scancode。unicode 代表一个按键翻译后的 Unicode 编码，这包含 shift 按键和组合键。scancode 是扫描码，不同键盘间该值可能不同。不过这对于特殊按键像多媒体键的选择是有用的。

温馨提示：当键盘按下的时候，键盘会发送一个扫描码给系统。扫描码是键盘反馈哪一个按键被按下的方式，不同类型的键盘扫描码不同。再由系统调用相应的函数将其转换为统一的 Unicode 编码。

key 属性的值是一个数字，为了方便使用，Pygame 将这些数字定义为以下这些常量：

KeyASCII	ASCII	描述
K_BACKSPACE	\b	退格键（Backspace）
K_TAB	\t	制表键（Tab）
K_CLEAR		清楚键（Clear）
K_RETURN	\r	回车键（Enter）
K_PAUSE		暂停键（Pause）
K_ESCAPE	^[	退出键（Escape）
K_SPACE		空格键（Space）
K_EXCLAIM	!	感叹号（exclaim）
K_QUOTEDBL	"	双引号（quotedbl）
K_HASH	#	井号（hash）
K_DOLLAR	$	美元符号（dollar）
K_AMPERSAND	&	and 符号（ampersand）
K_QUOTE	'	单引号（quote）
K_LEFTPAREN	(	左小括号（left parenthesis）
K_RIGHTPAREN	)	右小括号（right parenthesis）
K_ASTERISK	*	星号（asterisk）
K_PLUS	+	加号（plus sign）
K_COMMA	,	逗号（comma）
K_MINUS	-	减号（minus sign）
K_PERIOD	.	句号（period）
K_SLASH	/	正斜杠（forward slash）
K_0	0	0
K_1	1	1
K_2	2	2
K_3	3	3
K_4	4	4
K_5	5	5
K_6	6	6
K_7	7	7
K_8	8	8
K_9	9	9
K_COLON	:	冒号（colon）
K_SEMICOLON	;	分号（semicolon）
K_LESS	<	小于号（less-than sign）
K_EQUALS	=	等于号（equals sign）
K_GREATER	>	大于号（greater-than sign）
K_QUESTION	?	问号（question mark）
K_AT	@	at 符号（at）
K_LEFTBRACKET	[	左中括号（left bracket）
K_BACKSLASH	\	反斜杠（backslash）
K_RIGHTBRACKET	]	右中括号（right bracket）
K_CARET	^	脱字符（caret）
K_UNDERSCORE	_	下划线（underscore）
K_BACKQUOTE	`	重音符（grave）
K_a	a	a
K_b	b	b
K_c	c	c
K_d	d	d
K_e	e	e
K_f	f	f
K_g	g	g
K_h	h	h
K_i	i	i
K_j	j	j
K_k	k	k
K_l	l	l
K_m	m	m
K_n	n	n
K_o	o	o
K_p	p	p
K_q	q	q
K_r	r	r
K_s	s	s
K_t	t	t
K_u	u	u
K_v	v	v
K_w	w	w
K_x	x	x
K_y	y	y
K_z	z	z
K_DELETE		删除键（delete）
K_KP0		0（小键盘）
K_KP1		1（小键盘）
K_KP2		2（小键盘）
K_KP3		3（小键盘）
K_KP4		4（小键盘）
K_KP5		5（小键盘）
K_KP6		6（小键盘）
K_KP7		7（小键盘）
K_KP8		8（小键盘）
K_KP9		9（小键盘）
K_KP_PERIOD	.	句号（小键盘）
K_KP_DIVIDE	/	除号（小键盘）
K_KP_MULTIPLY	*	乘号（小键盘）
K_KP_MINUS	-	减号（小键盘）
K_KP_PLUS	+	加号（小键盘）
K_KP_ENTER	\r	回车键（小键盘）
K_KP_EQUALS	=	等于号（小键盘）
K_UP		向上箭头（up arrow）
K_DOWN		向下箭头（down arrow）
K_RIGHT		向右箭头（right arrow）
K_LEFT		向左箭头（left arrow）
K_INSERT		插入符（insert）
K_HOME		Home 键（home）
K_END		End 键（end）
K_PAGEUP		上一页（page up）
K_PAGEDOWN		下一页（page down）
K_F1		F1
K_F2		F2
K_F3		F3
K_F4		F4
K_F5		F5
K_F6		F6
K_F7		F7
K_F8		F8
K_F9		F9
K_F10		F10
K_F11		F11
K_F12		F12
K_F13		F13
K_F14		F14
K_F15		F15
K_NUMLOCK		数字键盘锁定键（numlock）
K_CAPSLOCK		大写字母锁定键（capslock）
K_SCROLLOCK		滚动锁定键（scrollock）
K_RSHIFT		右边的 shift 键（right shift）
K_LSHIFT		左边的 shift 键（left shift）
K_RCTRL		右边的 ctrl 键（right ctrl）
K_LCTRL		左边的 ctrl 键（left ctrl）
K_RALT		右边的 alt 键（right alt）
K_LALT		左边的 alt 键（left alt）
K_RMETA		右边的元键（right meta）
K_LMETA		左边的元键（left meta）
K_LSUPER		左边的 Window 键（left windows key）
K_RSUPER		右边的 Window 键（right windows key）
K_MODE		模式转换键（mode shift）
K_HELP		帮助键（help）
K_PRINT		打印屏幕键（print screen）
K_SYSREQ		魔术键（sysrq）
K_BREAK		中断键（break）
K_MENU		菜单键（menu）
K_POWER		电源键（power）
K_EURO		欧元符号（euro）

还有一个 mod 属性，用于描述组合键状态。

以下是组合键的常量定义：

KeyASCII	描述
KMOD_NONE	木有同时按下组合键
KMOD_LSHIFT	同时按下左边的 shift 键
KMOD_RSHIFT	同时按下右边的 shift 键
KMOD_SHIFT	同时按下 shift 键
KMOD_CAPS	同时按下大写字母锁定键
KMOD_LCTRL	同时按下左边的 ctrl 键
KMOD_RCTRL	同时按下右边的 ctrl 键
KMOD_CTRL	同时按下 ctrl 键
KMOD_LALT	同时按下左边的 alt 键
KMOD_RALT	同时按下右边的 alt 键
KMOD_ALT	同时按下 alt 键
KMOD_LMETA	同时按下左边的元键
KMOD_RMETA	同时按下右边的元键
KMOD_META	同时按下元键
KMOD_NUM	同时按下数字键盘锁定键
KMOD_MODE	同时按下模式转换键

温馨提示：如果 mod & KMOD_CTRL 是真的话，表示用户同时按下了 Ctrl 键。

函数详解

pygame.key.get_focused()

当窗口获得键盘的输入焦点时返回 True。

get_focused() -> bool

当窗口获得键盘的输入焦点时返回 True，如果窗口需要确保不失去键盘焦点，可以使用 pygame.event.set_grab(True) 独占所有的输入接口。

温馨提示：注意，这样做你就无法将鼠标移出窗口客户区了，但你仍然可以通过 Ctrl - Alt - Delete 热键“解围”。

pygame.key.get_pressed()

获取键盘上所有按键的状态。

get_pressed() -> bools

返回一个由布尔类型值组成的序列，表示键盘上所有按键的当前状态。使用 key 常量作为索引，如果该元素是 True，表示该按键被按下。

使用该函数获取一系列按钮被按下的状态，并不能正确的获取用户输入的文本。因为你无法知道用户按键的被按下的顺序，并且快速的连续按下键盘可能无法完全被捕获（在两次调用 pygame.key.get_pressed() 的过程中被忽略），也无法将这些按下的按键完全转化为字符值。实现此功能可以通过捕获 pygame.KEYDOWN 事件消息来实现。

pygame.key.get_mods()

检测是否有组合键被按下。

get_mods() -> int

返回一个包含所有组合键位掩码的整数。使用位操作符 & 你可以检测某个组合键是否被按下。

温馨提示：假如 pygame.key.get_mods() 返回值存放在 mods 变量中，如果 mods & KMOD_CTRL 为 True，表示 ctrl 键正被按下。

pygame.key.set_mods()

临时设置某些组合键为被按下状态。

set_mods(int) -> None

创建一个位掩码整数，包含你需要设置为被按下状态的组合键。

温馨提示：比如我们需要设置 ctrl 和 alt 组合键为按下状态，则可以 mods = KMOD_CTRL | KMOD_ALT，然后调用 pygame.key.set_mods(mods)，这样尽管用户没有按下 ctrl 和 alt 组合键，它们依然是显示被按下状态。

pygame.key.set_repeat()

控制重复响应持续按下按键的时间。

set_repeat() -> None

set_repeat(delay, interval) -> None

当开启重复响应按键，那么用户持续按下某一按键，就会不断产生同一 pygame.KEYDOWN 事件。delay 参数设置多久后（单位是毫秒）开始发送第一个 pygame.KEYDOWN 事件。interval 参数设置发送两个事件之间的间隔。如果不传入任何参数，表示取消重复响应按键。

pygame.key.get_repeat()

获取重复响应按键的参数。

get_repeat() -> (delay, interval)

当开启重复响应按键，那么用户持续按下某一按键，就会不断产生同一 pygame.KEYDOWN 事件。返回值是一个二元组，第一个元素 delay 表示多久后（单位是毫秒）开始发送第一个 pygame.KEYDOWN 事件。第二个元素 interval 表示发送两个事件之间的间隔。

默认情况下重复响应按键是没有开启的。

Pygame 1.8 新增加的。

pygame.key.name()

获取按键标识符对应的名字。

name(key) -> string

获取一个按键标识符对应的字符串描述。