key

类型 事件
修订版 版本 2024.3703
关键字 key

概览

当键盘键或游戏手柄/操纵杆按钮按下或松开时,会发生按键事件。

在按键事件侦听器中,您可以返回 true 以指示您的应用将处理收到的按键,并覆盖操作系统的默认行为。例如,在 Android 中,对返回键返回 true 将阻止操作系统退出您的应用。

在按键事件侦听器中返回 false 表示您的应用不会覆盖按键并允许操作系统执行其默认行为。

在 Corona 模拟器中,您可以通过以下方式模拟 Android 设备中的返回键事件:硬件返回菜单项目。这将分派两个按键事件,其中 event.keyName 等于 "back":一个 event.phase 等于 "down",另一个等于 "up"。请注意,如果您在“up”阶段没有返回 true 来覆盖键,则 Corona 模拟器会退出应用,就像它在真实设备上运行一样。

平台支持

Android

Android 为所有键盘键、导航按钮、音量按钮和游戏手柄/操纵杆按钮生成按键事件。Android 不会 为 Home 导航按钮、任务管理器按钮或电源按钮生成按键事件。

iOS

支持来自 MFi 游戏控制器 (指南) 的按键事件和键盘键(如果使用 Solar 3685+ 构建)。

macOS

适用于 macOS 和 macOS 桌面应用程序的 Corona 模拟器支持所有键盘键和游戏手柄/操纵杆按钮。

Win32 桌面

适用于 Windows 和 Win32 桌面应用程序的 Corona 模拟器支持所有键盘键。适用于 Windows 的 Corona 模拟器仅在模拟 Android 设备时才提供按键事件。

注意事项

如果 TextFieldTextBoxWebView 等原生对象处理按键事件,则不会收到按键事件。只有在这些原生对象获得焦点并且它们选择覆盖此键时,才会发生这种情况。例如,TextFieldTextBox 通常处理所有键盘键,阻止应用程序接收这些按键事件,但不会处理返回键事件。

属性

event.descriptor

event.device

event.isAltDown

event.isCommandDown

event.isCtrlDown

event.isShiftDown

event.keyName

event.name

event.nativeKeyCode

event.phase