JoyCursor

在 1.10.0 版本加入.

JoyCursor 是一个用于通过操纵杆进行导航的工具,其操作方式类似于使用鼠标或触摸屏。本模块提供了鼠标用户可执行的大部分操作。

例如:

  • 左键单击

  • 右键点击

  • 双击(两次点击)

  • 移动光标

  • 按住按钮(同时移动)

  • 选择

  • 滚动

有一些属性可以实时编辑,例如JoyCursor移动的强度以及鼠标按钮按下的切换。

用法

对于常规模块使用,请参阅 modules 文档及以下绑定:

事件

操纵杆

光标移动

轴3,轴4

光标强度

按钮0,按钮1

左键单击

按钮 2

右键点击

按钮 3

向上滚动

按钮 4

向下滚动

按钮 5

按住按钮

按钮 6

joycursor 开/关

按钮 7

JoyCursor 与 Inspector 类似,也可以作为普通 Python 模块导入和使用。这样做的一个额外优势是能够以编程方式激活和停用该模块:

from kivy.lang import Builder
from kivy.base import runTouchApp
runTouchApp(Builder.load_string("""
#:import jc kivy.modules.joycursor
BoxLayout:
    Button:
        text: 'Press & activate with Ctrl+E or Button 7'
        on_release: jc.create_joycursor(root.parent, root)
    Button:
        text: 'Disable'
        on_release: jc.stop(root.parent, root)
"""))
kivy.modules.joycursor.create_joycursor(win, ctx, *args)[源代码]

创建一个 JoyCursor 实例,将其附加到 ctx 上,并绑定到 Window 的 on_keyboard() 事件,以捕获键盘快捷键。

参数:
win:一个 Window

要绑定的应用程序窗口。

ctx:一个 Widget 或其子类

JoyCursor 所附加的 Widget。

kivy.modules.joycursor.stop(win, ctx)[源代码]

停止并卸载给定 ctx 的所有活动 JoyCursor。