Kivy 简明教程
Kivy - VKeyboard
Kivy 库中的 VKeyboard 插件对于运行于多点触控设备（例如智能手机和平板电脑）的应用程序特别有用。VKeyboard 是一个屏幕键盘。其操作对用户而言应当是透明的。
VKeyboard 用于 docked 和 free mode 两种模式。自由模式适用于多点触控设备，而固定模式在使用类似平板电脑的计算机时启用。
VKeyboard 类在 kivy.uix.vkeyboard 模块中定义。
from kivy.uix.vkeyboard import VKeyboard
kb = VKeyboard(**kwargs)虚拟键盘决不直接使用。相反，它受配置控制。如果应用程序包含任何要求键盘的插件（例如 TextInput），则不要直接使用虚拟键盘，而是首选使用平台上可用的最佳方法。
VKeyboard 类继承了 ScatterLayout。虚拟键盘插件右下角的按钮让你在可用的布局之间切换。
VKeyboard 对象具有以下属性 −
-
available_layouts − 所有可用布局的字典。键是布局 ID，值是 JSON，默认为 {}。
-
callback − 回调可设置为一个函数，这个函数如果由用户关闭了 VKeyboard，就会被调用。
-
docked − 指出 VKeyboard 是否固定在屏幕上。如果你改变它，你必须手动调用 setup_mode()，否则它不会有任何影响。
-
key_margin − 键边距，用于在键之间创建空间。边距由 4 个以像素为单位的值组成 −
key_margin = [top, right, bottom, left]key_margin 默认为 [2, 2, 2, 2]
-
target − 与 VKeyboard 关联的目标插件。如果设置了它，它将被用于发送键盘事件。
Example
在以下示例中，单列网格布局的初始组成显示了一个标签和一个 TextInput 插件。随着用户单击文本框内部而生成 touch_down 事件，VKeyboard 插件被添加到该布局中。
def ontouch(self, instance, value):
self.kb = VKeyboard(
on_key_up = self.vkbinput,
pos_hint={'center_x':.5},
size_hint=(.8, None)
)
self.layout.add_widget(self.kb)当键盘上的任何键被按下时，它会生成 on_key_up 事件。它绑定到 vkbinput() 方法。此方法读取被按下的键的键码并更新文本框的内容。
def vkbinput(self, keyboard, keycode, *args):
text = self.text1.text
if keycode == '~':
self.layout.remove_widget(self.kb)
return
self.text1.text = f'{text}{keycode}'每当用户按下“~”键时，键盘组件就会从布局中移除。
complete code 如下所示 -
from kivy.app import App
from kivy.uix.vkeyboard import VKeyboard
from kivy.uix.textinput import TextInput
from kivy.uix.label import Label
from kivy.uix.gridlayout import GridLayout
from kivy.core.window import Window
Window.size = (720, 400)
class MainApp(App):
def build(self):
self.layout = GridLayout(cols=1)
self.text1 = TextInput(
font_size=32,
on_touch_down=self.ontouch
)
self.label = Label(
text="Enter Text....",
font_size=32,
color=[.8, .6, .1]
)
self.layout.add_widget(self.label)
self.layout.add_widget(self.text1)
return self.layout
def ontouch(self, instance, value):
self.kb = VKeyboard(
on_key_up=self.vkbinput,
pos_hint={'center_x': .5},
size_hint=(.8, None)
)
self.layout.add_widget(self.kb)
def vkbinput(self, keyboard, keycode, *args):
text = self.text1.text
if keycode == '~':
self.layout.remove_widget(self.kb)
return
self.text1.text = f'{text}{keycode}'
MainApp().run()
