如何将Gtk Notebook页面拖放至新窗口？求实现示例

阿华AIGC实验室

2026-5-13

实现Gtk Notebook页面拖放到新窗口的方法及示例

要实现把Gtk Notebook的标签页拖放到新窗口的功能，核心是利用Gtk的拖放（DND）框架，处理拖放发起、数据传递和目标接收三个环节。下面我会一步步拆解实现思路，再给出完整的可运行示例。

核心思路

Gtk 4的DND系统依赖Gtk.DragSource（发起拖放）和Gtk.DropTarget（接收拖放）两个核心组件。我们需要：

让Notebook的标签栏区域能触发拖放动作，同时传递被拖动页面的关键信息（比如页面widget、标题）；
监听拖放结束事件，在成功接收时创建新窗口，把原页面从旧Notebook迁移到新窗口的Notebook中。

具体实现步骤

1. 为Notebook标签栏配置拖放源

创建Gtk.DragSource并设置拖放动作为Gdk.DragAction.MOVE（表示移动操作）；
在drag-begin信号回调中，通过鼠标位置获取当前被拖动的标签页，记录页面索引、widget和标题文本，作为拖放数据传递出去；
把拖放源添加到Notebook的标签栏容器上，确保拖动标签时能触发拖放。

2. 设置全局拖放目标

创建Gtk.DropTarget，指定接收的数据类型（这里用字符串列表传递索引和标题）；
在drop信号回调中，解析传递的数据，创建新窗口和新的Notebook组件；
将原页面从旧Notebook中移除，添加到新窗口的Notebook里，并设置对应标题。

3. 处理拖放的边界情况

只有拖放成功时才移除原页面，避免拖放取消后页面丢失；
确保页面widget在迁移时的内存安全（Gtk的widget移除后不会自动销毁，直接添加到新容器即可）。

完整可运行示例（Python + Gtk 4）

import gi
gi.require_version('Gtk', '4.0')
from gi.repository import Gtk, Gdk

class MainWindow(Gtk.ApplicationWindow):
    def __init__(self, app):
        super().__init__(application=app, title="Notebook DND Demo")
        self.set_default_size(600, 400)

        # 初始化主Notebook并添加测试页面
        self.notebook = Gtk.Notebook()
        self.set_child(self.notebook)
        for i in range(3):
            page_content = Gtk.Label(label=f"Page {i+1} Content Area")
            tab_label = Gtk.Label(label=f"Tab {i+1}")
            self.notebook.append_page(page_content, tab_label)

        # 配置拖放源和拖放目标
        self.setup_drag_source()
        self.setup_drop_target()

    def setup_drag_source(self):
        drag_source = Gtk.DragSource()
        drag_source.set_actions(Gdk.DragAction.MOVE)

        # 拖放开始时获取并传递页面信息
        def on_drag_begin(source, drag, data):
            # 通过鼠标位置找到对应的标签页
            tab_widget = self.notebook.get_tab_at_pos(drag.get_x(), drag.get_y())
            if not tab_widget:
                return
            page_index = self.notebook.page_num(tab_widget.get_parent())
            if page_index == -1:
                return

            # 获取页面内容和标题，打包成字符串列表传递
            page = self.notebook.get_nth_page(page_index)
            tab_text = self.notebook.get_tab_label(page).get_text()
            source.set_content(Gtk.StringList.new([str(page_index), tab_text]))
            # 临时保存索引，方便后续处理
            source.page_index = page_index

        drag_source.connect("drag-begin", on_drag_begin)
        # 把拖放源绑定到标签栏容器
        self.notebook.get_tab_bar().add_controller(drag_source)

    def setup_drop_target(self):
        drop_target = Gtk.DropTarget.new(Gtk.StringList, Gdk.DragAction.MOVE)

        # 拖放成功时创建新窗口并迁移页面
        def on_drop(target, value, x, y):
            page_index = int(value.get_string(0))
            tab_text = value.get_string(1)
            page = self.notebook.get_nth_page(page_index)
            if not page:
                return False

            # 创建新窗口和新Notebook
            new_window = Gtk.ApplicationWindow(application=self.get_application(), title=tab_text)
            new_window.set_default_size(400, 300)
            new_notebook = Gtk.Notebook()
            new_window.set_child(new_notebook)

            # 从原Notebook移除页面，添加到新窗口
            self.notebook.remove_page(page_index)
            new_notebook.append_page(page, Gtk.Label(label=tab_text))

            new_window.present()
            return True

        drop_target.connect("drop", on_drop)
        self.add_controller(drop_target)

class MyApp(Gtk.Application):
    def __init__(self):
        super().__init__(application_id="org.example.NotebookDND")

    def do_activate(self):
        main_win = MainWindow(self)
        main_win.present()

if __name__ == "__main__":
    app = MyApp()
    app.run(None)