Kivy 简明教程
Kivy - Bubble
Kivy 框架包含一个 Bubble 小部件,作为一个小弹出菜单,其内容的任何一侧都带有一个箭头。可以根据需要配置箭头的方向。您可以通过设置其“arrow_pos”属性的相对位置来放置它。
气泡的内容放置在“BubbleContent”对象中,它是 BoxLayout 的子类。一个或多个 BubbleButton 可以水平或垂直放置。虽然建议使用 BubbleButton,但您可以在气泡内容中添加任何小部件。
Bubble、BubbleContent 和 BubbleButton 类在 kivy.uix.bubble 模块中定义。
from from kivy.uix.bubble import Bubble
Bubble 类的以下属性有助于自定义 Bubble 菜单的外观和行为 −
-
arrow_color − 箭头颜色,格式为 (r, g, b, a)。要使用它,您必须首先设置 arrow_image,默认为 [1, 1, 1, 1]。
-
arrow_image − 指向气泡的箭头的图像。
-
arrow_margin − 自动计算箭头小部件以像素为单位在 x 和 y 方向占据的边距。
-
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'。
-
content − 这是存放气泡主要内容的对象。
-
show_arrow − 指示是否显示箭头。默认为 True。
-
BubbleButton − 一个旨在在 BubbleContent 小部件中使用的按钮。您可以使用“普通”按钮来代替它,但除非更改了背景,否则它看起来可能很好。
-
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()