PYGLET – 键修饰符字符串

在 PYGLET 中，键修饰符字符串是一种表示按下特定按键时应使用的按键修饰符的字符串。这些字符串可以通过将字符串传递给键符号函数而动态生成。

键修饰符字符串的格式

键修饰符字符串形式为 单个按键名称 和 0 或多个 修饰符名称 的组合。修饰符名称用 '+' 分隔多个修饰符，修饰符的顺序不影响其含义。

以下是键修饰符字符串的合法格式示例：

• 'x'
• '-shift+x'
• 'a+control+alt'
• 'f1+shift+control'

支持的键名和修饰符名

以下是 PYGLET 支持的键名和修饰符名：

键名

键名表示常见的键盘按键，例如字母、数字、回车、退格、空格等等。示例：

• 'a'
• '1'
• 'return'
• 'backspace'
• 'space'

PYGLET 还支持通过特殊的符号来表示其他键，例如 F1 到 F12、左右方向键、鼠标左中右键等等。示例：

• 'f1'
• 'left'
• 'right'
• 'mouse_left'

修饰符名

修饰符名表示描述键盘状态的修饰符，例如 Shift、Control、Alt 等等。示例：

• 'shift'
• 'control'
• 'alt'

生成键修饰符字符串

可以通过使用 pyglet.window.key.symbol_string() 函数生成对应的键修饰符字符串。该函数接受一个有效的键符号，并返回该键符号的字符串表示形式。

下面是一个示例程序，用于动态生成及输出键修饰符字符串：

import pyglet

window = pyglet.window.Window()

@window.event
def on_key_press(symbol, modifiers):
    keystroke = pyglet.window.key.symbol_string(symbol, modifiers)
    print('keystroke:', keystroke)

pyglet.app.run()

该程序在窗口中运行，并在按下任何键时输出键修饰符字符串。

结论

本文介绍了 PYGLET 中键修饰符字符串的使用方法。通过使用键修饰符字符串可以轻松表示复杂的键盘按键和修饰符组合，方便程序员处理键盘输入。