Kivy 简明教程

Kivy - Bubble

Kivy 框架包含一个 Bubble 小部件,作为一个小弹出菜单,其内容的任何一侧都带有一个箭头。可以根据需要配置箭头的方向。您可以通过设置其“arrow_pos”属性的相对位置来放置它。

气泡的内容放置在“BubbleContent”对象中,它是 BoxLayout 的子类。一个或多个 BubbleButton 可以水平或垂直放置。虽然建议使用 BubbleButton,但您可以在气泡内容中添加任何小部件。

kivy bubble

Bubble、BubbleContent 和 BubbleButton 类在 kivy.uix.bubble 模块中定义。

from from kivy.uix.bubble import Bubble

Bubble 类的以下属性有助于自定义 Bubble 菜单的外观和行为 −

  1. arrow_color − 箭头颜色,格式为 (r, g, b, a)。要使用它,您必须首先设置 arrow_image,默认为 [1, 1, 1, 1]。

  2. arrow_image − 指向气泡的箭头的图像。

  3. arrow_margin − 自动计算箭头小部件以像素为单位在 x 和 y 方向占据的边距。

  4. arrow_pos − 根据预定义的值之一指定箭头的位置:left_top、left_mid、left_bottom top_left、top_mid、top_right right_top、right_mid、right_bottom bottom_left、bottom_mid、bottom_right。默认值为 'bottom_mid'。

  5. content − 这是存放气泡主要内容的对象。

  6. show_arrow − 指示是否显示箭头。默认为 True。

  7. BubbleButton − 一个旨在在 BubbleContent 小部件中使用的按钮。您可以使用“普通”按钮来代替它,但除非更改了背景,否则它看起来可能很好。

  8. BubbleContent − 一种可样式化的 BoxLayout,可以用作 Bubble 的内容小部件。

以下模式“kv”语言脚本来构建一个简单的 Bubble 对象 −

Bubble:
   BubbleContent:
      BubbleButton:
         text: 'Button 1'
      BubbleButton:
         text: 'Button 2'

就像正常按钮一样,我们可以将 BubbleButton 绑定到其“on_press”事件的回调。

Example

当执行以下代码时,会显示一个普通按钮。当单击时,会弹出一个包含三个 BubbleButton 的 Bubble 菜单。这些 BubbleButton 每个都会调用一个读取按钮标题并在控制台上打印它的 pressed() 回调方法。

我们使用以下“kv”语言脚本来组装 Bubble 菜单。已经定义了一个名为“Choices”的类,该类是“kivy.uix.bubble.Bubble”类的子类。

class Choices(Bubble):
   def pressed(self, obj):
      print ("I like ", obj.text)
      self.clear_widgets()

此类有 pressed() 实例方法,由每个 BubbleButton 调用。

以下是“kv”脚本 −

<Choices>
   size_hint: (None, None)
   size: (300, 150)
   pos_hint: {'center_x': .5, 'y': .6}
   canvas:
      Color:
         rgb: (1,0,0)
      Rectangle:
         pos:self.pos
         size:self.size
   BubbleContent:
      BubbleButton:
         text: 'Cricket'
         size_hint_y: 1
         on_press:root.pressed(self)
      BubbleButton:
         text: 'Tennis'
         size_hint_y: 1
         on_press:root.pressed(self)
      BubbleButton:
         text: 'Hockey'
         size_hint_y: 1
         on_press:root.pressed(self)

BoxLayout 小部件用作主应用程序窗口的根小部件,由一个 Button 和一个标签组成。“on_press”事件调用“show_bubble()”方法,弹出气泡。

class BubbleTest(FloatLayout):
   def __init__(self, **temp):
      super(BubbleTestApp, self).__init__(**temp)
      self.bubble_button = Button(
         text ='Your favourite Sport',
         pos_hint={'center_x':.5, 'center_y':.5},
         size_hint=(.3, .1),size=(300, 100)
      )
      self.bubble_button.bind(on_release = self.show_bubble)
      self.add_widget(self.bubble_button)

   def show_bubble(self, *arg):
      self.obj_bub = Choices()
      self.add_widget(self.obj_bub)

驱动器应用程序代码如下 -

from kivy.app import App
from kivy.uix.floatlayout import FloatLayout
from kivy.uix.button import Button
from kivy.uix.label import Label
from kivy.uix.bubble import Bubble
from kivy.properties import ObjectProperty
from kivy.core.window import Window

Window.size = (720,400)

class MybubbleApp(App):
   def build(self):
      return BubbleTest()

MybubbleApp().run()

Output

该应用程序在主窗口的中心显示一个按钮。单击后,您应该在该按钮上方看到气泡菜单。

kivy bubble menu

每次您单击气泡中的任何选项,控制台都会显示结果并隐藏气泡。

I like Tennis
I like Hockey