Kivy 简明教程

Kivy - Windows

Window 类是 Kivy 框架中的核心类之一。应用程序窗口使用将一个或多个控件放置在特定布局中来构建。build() 方法通常返回单个根控件,它可能是多个其他控件组合而成的,这些控件以树状结构排列。而控件树的根可以被直接添加到应用程序窗口中。

Window 类在 "kivy.core.window" 模块中定义。它继承自 WindowBase 类,这是一个用于任何窗口实现的抽象窗口控件。使用 App 对象启动其事件循环来创建默认应用程序窗口。请注意,Kivy 每个应用程序仅支持一个窗口。

Window 的许多属性是从 Kivy 配置文件(KIVY_HOME 目录中的 "config.ini" 文件)中读取的。

控件维度取决于默认窗口的大小。App 类的 build() 方法中的以下代码将控件树放置到应用程序窗口中。请注意,根控件不会由 build() 方法返回。相反,将其添加到 Window 对象的 add_widget() 方法。

box=BoxLayout(orientation='vertical')

l=Label(text='Window Properties', font_size=32)
box.add_widget(l)

b1=ToggleButton(text='Fullscreen')
b2=ToggleButton(text='Border')
b3=ToggleButton(text='Position')

bh=BoxLayout(orientation='horizontal', size_hint=(1, .2))
bh.add_widget(b1)
bh.add_widget(b2)
bh.add_widget(b3)

box.add_widget(bh)
Window.add_widget(box)

Events

Window 对象可以识别不同类型的事件:

  1. 当新 MotionEvent 被分派时,触发 on_motion 事件。

  2. 窗口吸收触摸事件 on_touch_down, on_touch_move, on_touch_up 等。

  3. 窗口关闭时,触发 on_close 事件。

  4. 当用户希望通过按标题栏上的关闭按钮来结束事件循环时,会发生 on_request_close 事件。

  5. 当光标进入窗口时,触发 on_cursor_enter 事件。

  6. 同样, 当光标离开窗口时,会发生 on_cursor_leave 事件。

  7. 当窗口最小化和最大化后,会激发 on_minimize and on_maximize 事件。

  8. 当窗口恢复时,会激发 on_restore 事件。

与触摸事件类似,当按下或释放某个键时,键盘事件 on_key_down 和 on_key_up 会发出键、扫描码、代码点和模式。

在本章的演示示例中,我们用回调方法绑定一些窗口事件。

Window.bind(on_request_close = self.on_close)
Window.bind(on_cursor_leave=self.on_leave)
Window.bind(on_cursor_enter=self.on_enter)

无论何时鼠标指针离开窗口区域,on_leave() 方法都将被调用。

def on_leave(self, *args):
   print ("leaving the window")

同样,当鼠标进入窗口区域时,会调用 on_enter 回调。

def on_enter(self, *args):
   print ("Entering the window")

当用户选择关闭事件循环时,会引发 on_request_close 事件。如果用户按 X 按钮,以下回调则询问用户是否要退出。您还可以使弹出窗口出现。

def on_close(self, instance):
   resp=input("Do you want the window to close?")
   if resp=='y': Window.close()

Properties

应用程序窗口的外观由 Window 类中定义的许多属性决定。它们的默认值由 config.ini 文件提供。但是,可以在应用程序代码中修改它们。部分窗口属性如下所示:

  1. borderless − 当设置为 True 时,此属性会移除窗口边框/装饰。

  2. children − 返回此窗口的子项列表。

  3. clearcolor − 用于清除窗口的颜色。clear() 方法用此颜色的值使用此属性

from kivy.core.window import Window
Window.clearcolor = (1, 0, 0, 1)
Window.clear()
  1. custom_titlebar − 当设置为 True 时,允许用户设置窗口小部件为标题栏。

  2. fullscreen − 此属性设置窗口的全屏模式。可用的选项是:True、False、“auto”和“fake”。

  3. left , top − 窗口的左上角位置。这是 SDL2 的属性,左上角是 [0, 0]。

  4. size − 获取/设置窗口的大小。

from kivy.core.window import Window
Window.size = (720,400)

您还可以通过修改 config 值来设置大小:

from kivy.config import Config
Config.set('graphics', 'width', '720')
Config.set('graphics', 'height', '400')
Config.set('graphics', 'resizable', '1')

我们处理一些窗口属性。在这个程序的应用程序窗口上,我们有三个切换按钮。我们用回调将其绑定。

b1.bind(on_press=self.pressed)
b2.bind(on_press=self.bordered)
b3.bind(on_press=self.positioned)

pressed() 方法在全屏和正常之间切换全屏状态。

def pressed(self, instance):
   if instance.state=='down':
      Window.set_title("Kivy Full screen window")
      Window.maximize()
   elif instance.state=='normal':
      Window.set_title('Kivy Restored Window')
      Window.restore()

在按下 b2 按钮时,bordered() 方法使窗口无边框,而在释放时返回原始边框窗口。

def bordered(self, instance):
   print (Window.top, Window.left)
   if instance.state=='down':
      Window.borderless=True
   elif instance.state=='normal':
      Window.borderless=False

positioned() 回调将窗口移动到 (0,0) 位置,并在按下/释放 b3 时返回到其先前位置。

def positioned(self, instance):
   print (Window.top, Window.left)
   if instance.state=='down':
      self.x, self.y=Window.left, Window.top
      Window.left, Window.top=(0,0)
   elif instance.state=='normal':
      Window.left, Window.top=self.x,self.y

在开始时,Application 窗口如下所示。生成事件(在 request_close 上鼠标离开、进入)并查看回调动作。同样检查切换按钮的动作。

kivy windows