Python GTK 3 GUI 编程 -- 005 容器#4 堆叠容器(Stack) 和 堆叠切换器(Stack Switcher)

这篇文章讲下堆叠容器 以及切换器

什么是堆叠容器

图中上面的按钮是切换器, 下面的是容器

Stack 1

Stack 2

堆叠容器其实就向Notebook容器, 一次只能显示一个页面, 通过切换器(或相关函数)来切换页面
我们可以看到, 一个切换器对应一个容器, 切换器管切换页面

如何创建一个stack 和 stack switcher

self.stack = Gtk.Stack()
self.stack_switcher = Gtk.StackSwitcher(stack=self.stack) # 使用stack属性指定切换器控制的容器

容器可以通过add_named(child, name) 或 add_titled(child, name, title) 来添加子控件

• 上面两个方法的区别
  • name 是一个子控件的唯一标识符
  • title 是在切换器上显示的文字, 供人类阅读
  • 所以如果不需要切换器, 那么用add_named就可以, 需要切换器的加一个title 来供人类阅读, 理智选择

上面示例的完整代码

import gi
gi.require_version("Gtk", "3.0")

from gi.repository import Gtk


class MyWindow(Gtk.Window):
    def __init__(self):
        super(MyWindow, self).__init__(title="Stack And Stack Switch")

        self.box = Gtk.Box(orientation=Gtk.Orientation.VERTICAL, spacing=6)
        self.add(self.box)

        self.stack = Gtk.Stack()
        self.stack_switcher = Gtk.StackSwitcher(stack=self.stack)
        self.box.pack_start(self.stack_switcher, False, False, 0)
        self.box.pack_start(self.stack, True, True, 0)

        self.label = Gtk.Label(label="I am a label")
        self.btn = Gtk.Button(label="I am a button")
        self.stack.add_titled(self.label, "label", "Label")
        self.stack.add_titled(self.btn, "button", "Button")


win = MyWindow()
win.connect("destroy", Gtk.main_quit)
win.show_all()
Gtk.main()

Stack的过渡动画

Stack可以设置切换时的过渡动画
通过transition_type属性和transition_duritaion属性
transition_type接受 Gtk.StackTransitionType类型

Gtk.StackTransitionType 枚举
NONE = 0
CROSSFADE = 1 淡入
OVER_LEFT = 10 从左向右飞入
OVER_RIGHT = 11 从右向左飞入
OVER_UP = 8
OVER_DOWN = 9
UNDER_UP = 12 原先控件向上飞出
UNDER_DOWN = 13 原先控件向下飞出
UNDER_LEFT = 14 原先控件向左飞出
UNDER_RIGHT = 15 原先控件向右飞出
OVER_LEFT_RIGHT = 18 根据控件先后顺序, 决定是向左还是向右, 第一个控件效果为OVER_LEFT, 第二个为OVER_RIGHT, 下面的以此类推
OVER_RIGHT_LEFT = 19
OVER_UP_DOWN = 16
OVER_DOWN_UP = 17
SLIDE_RIGHT = 2 向右滑动
SLIDE_LEFT = 3 向左滑动
SLIDE_TOP = 4 向上滑动
SLIDE_DOWN = 5 向下滑动
SLIDE_UP_DOWN = 7 上面说过
SLIDE_LEFT_RIGHT = 6
根据官方api参考, 没有SLDE_DOWN_UP 和 SLIDE_RIGHT_LEFT

Stack的常用属性

• homogeneous 子控件是否等宽和等高
• hhomogeneous 子控件是否等宽
• vhomogeneous 子控件是否等高
• transition_type 动画类型
• transition_duration 动画时长, 以毫秒为单位

Stack的常用方法

• add_named(child, name)
• add_titled(child, name, title)
• get_child_by_name(name) 通过名字获取控件, 上面说过name是唯一标识符
• 还有一些设置和获取属性的方法, 不用多说了吧

下篇文章讲下标签控件(Label), 为什么这个时候讲, 因为前面忘了
欢迎留言