Python GTK 3 GUI 编程 -- 005 容器#3 笔记本容器(Notebook))

这篇文章介绍Notebook容器
首先

什么是笔记本

Notebook Page1
Notebook Page2

可以添加多个页面, 每次只能有一个页面显示, 这就是Notebook容器
主要继承关系 Gtk.Notebook < Gtk.Container < Gtk.Widget

如何创建一个笔记本

通过实例化Gtk.Notebook来创建 self.notebook = Gtk.Notebook()

笔记本的使用

使用append_page(child, tab_label), 来创建页面, 如果需要用到弹出式菜单来切换页面, 可以用append_page_menu(child, tab_label, menu_label)来指定页面在弹出式菜单的标签

Notebook的弹出式菜单就是在标签页上右键弹出的页面切换菜单, 需要通过设置enable_popup=True开启, self.notebook = Gtk.Notebook(enable_popup=True)

Popup menu

由于linux在右键弹出式菜单无法截图, 所以只能拍照了
上面的就是弹出式页面切换菜单, 通过设置menu_label可以指定显示的标签, 如果未制定, 则与tab_label一样

  • append_page(child, tab_label)
    • child 被放置的控件
    • tab_label 切换栏显示的标签, 接受Gtk.Label, 如果为None, 默认为 Page N
  • append_page_menu(child, tab_label, menu_label)
    • menu_label 页面在弹出式菜单的标签

一个页面只能传入一个子控件

示例

Example 1
Example 2
  • 原始码实现

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="Notebook Container")

        self.notebook = Gtk.Notebook()
        self.add(self.notebook)

        self.box = Gtk.Box(spacing=6)
        self.switch = Gtk.Switch()
        self.label = Gtk.Label(label="Switch me")
        self.box.pack_start(self.label, True, True, 0)
        self.box.pack_start(self.switch, False, False, 0)

        self.label2 = Gtk.Label(label="You have been distracted")

        self.notebook.append_page(self.box, Gtk.Label(label="pAge 1"))
        self.notebook.append_page(self.label2, Gtk.Label(label="PagE 2"))


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

常用方法

  • append_page(child, tab_label)
  • append_page_menu(child, tab_label, menu_label) 上面讲过了
  • detach_tab(child) 移除标签, 通过传出子控件移除
  • get_current_page() 获取当前活动页面
  • get_n_pages() 获取总页数
  • get_nth_page(page_num) 获取第n页的子控件, 返回Gtk.Widget
  • get_tab_label(child) 获取标签(创建页面时传入的tab_label), 返回Gtk.Label
  • get_tab_label_text(child) 获取标签内容, 返回str或None
  • get_menu_label(child) 获取菜单标签(创建页面时传入的menu_label), 返回Gtk.Label
  • get_menu_label_text(child) 获取菜单标签内容, 返回str或None
  • insert_page(child, tab_label, position) 在第n页插入页面, position整形, 第n页
  • insert_page_menu(child, tab_label, menu_label, position)
  • page_num(child) 获取第几页通过传入子控件
  • remove_page(page_num) 移除页面通过传入第几页
  • set_menu_label(child, menu_label) 设置menu_label通过传入child
  • set_menu_label_text(child, menu_text) 修改menu_label的文字通过传入child
  • set_tab_label(child, tab_label) 设置tab_label通过传入child
  • set_tab_label_text(child, tab_text) 设置tab_label的文字通过传入child
  • next_page() 下一页

常用属性

  • enable_popup 是否启用弹出式页面切换菜单
  • scrollable 是否滚动, 如果有非常多的页面是, 将不会挤在一起, 而是显示一个滚动条
  • show_border 是否展示边框
  • show_tabs 是否显示标签栏
  • tab_pos 标签栏的位置 接受Gtk.PositionType类型(Gtk.PositionType是什么, 上篇文章讲过, 不了解的话看下上一篇文章)

欢迎大家留言, 下篇文章讲下 Flowbox(自适应的盒子)

你可能感兴趣的:(Python GTK 3 GUI 编程 -- 005 容器#3 笔记本容器(Notebook)))