PyQt6单个QPushButton多框架复用问题及解决方案咨询

我正在开发一款具备多图层功能的PyQt6应用，不同图层功能存在差异，但部分功能（如通用启用按钮）在所有图层中逻辑完全一致。为避免用户切换图层后需返回原图层执行通用操作，希望复用单个QPushButton而非为每个图层创建独立按钮。

遇到的问题 #

首次尝试时出现错误：

RuntimeError: wrapped C/C++ object of type QDoubleSpinBox has been deleted

推测该问题与Qt控件所有权机制相关。编写简化复现程序后，虽未复现上述删除错误，但发现当将同一按钮添加到QStackedWidget的多个面板时，按钮会从之前的面板中移除，仅显示在最后添加的面板中。希望切换面板时无需重建面板，即可让按钮显示在当前激活的面板中，咨询此类场景的常规处理方式。

简化复现代码 #

import sys

from PyQt6.QtCore import Qt
from PyQt6.QtWidgets import (
    QApplication,
    QFrame,
    QMainWindow,
    QPushButton,
    QSplitter,
    QStackedWidget,
    QVBoxLayout,
    QWidget,
)


class IO:
    def __init__(self) -> None:
        self.button = QPushButton("Panel A")

    def get_io(self):
        return self.button


class FrameA:
    def get_frame(self, btn):
        frame = QFrame()
        frame.setFrameShape(QFrame.Shape.NoFrame)
        frame.setLineWidth(0)
        frame.setMidLineWidth(0)

        layout = QVBoxLayout(frame)
        layout.addWidget(btn)

        return frame


class PanelA(QWidget):
    def __init__(self, io, parent=None):
        QWidget.__init__(self)
        self.parent = parent
        self.build_panel(io)

    def build_panel(self, btn):
        layout = QVBoxLayout()
        vertical_splitter = QSplitter(Qt.Orientation.Vertical)
        vertical_splitter.setStyleSheet("QSplitter::handle {image: none;}")
        vertical_splitter.addWidget(FrameA().get_frame(btn))

        layout.addWidget(vertical_splitter)
        self.setLayout(layout)


class PanelB(QWidget):
    def __init__(self, io, parent=None):
        QWidget.__init__(self)
        self.parent = parent
        self.build_panel(io)

    def build_panel(self, btn):
        layout = QVBoxLayout()
        vertical_splitter = QSplitter(Qt.Orientation.Vertical)
        vertical_splitter.setStyleSheet("QSplitter::handle {image: none;}")
        vertical_splitter.addWidget(FrameA().get_frame(btn))

        layout.addWidget(vertical_splitter)
        self.setLayout(layout)


class UI(QWidget, IO):
    def __init__(self, parent=None):
        QWidget.__init__(self)
        IO.__init__(self)

        layout = QVBoxLayout()
        self.stack = QStackedWidget()

        self.stack.addWidget(PanelA(self.get_io()))
        self.stack.addWidget(PanelB(self.get_io()))
        self.stack.setCurrentIndex(1)

        layout.addWidget(self.stack)
        self.setLayout(layout)

        self.init_btn_connections()

    def init_btn_connections(self):
        self.button.clicked.connect(lambda: self.btnstate(self.button))

    def btnstate(self, btn):
        print(f"Button: {btn}")

        if btn.text() == "Panel A":
            print(f"----> Button, Current Stack Idx: {self.stack.currentIndex()}")
            self.button.setText("Panel B")
            self.stack.setCurrentIndex(1)
            print(f"	Switched to stack index: {self.stack.currentIndex()}")
        elif btn.text() == "Panel B":
            print(f"---> Default, Current Stack Idx: {self.stack.currentIndex()}")
            self.button.setText("Panel A")
            self.stack.setCurrentIndex(0)


class App(QMainWindow):
    def __init__(self):
        QMainWindow.__init__(self)
        self.gui = UI()
        self.setCentralWidget(self.gui)


def main():
    app = QApplication(sys.argv)
    ex = App()
    ex.show()
    sys.exit(app.exec())


if __name__ == "__main__":
    main()

常规处理方式 #

方案1：将通用按钮放在QStackedWidget外部 #

把通用按钮从面板中剥离，放在QStackedWidget的父布局里，这样无论切换哪个面板，按钮始终可见。这种方式最简单，无需处理控件移动逻辑，适合通用操作按钮。

修改UI类的布局逻辑：

class UI(QWidget, IO):
    def __init__(self, parent=None):
        QWidget.__init__(self)
        IO.__init__(self)

        layout = QVBoxLayout()
        # 先添加通用按钮到父布局
        layout.addWidget(self.button)
        
        self.stack = QStackedWidget()
        # 面板不再接收按钮参数
        self.stack.addWidget(PanelA())
        self.stack.addWidget(PanelB())
        self.stack.setCurrentIndex(1)

        layout.addWidget(self.stack)
        self.setLayout(layout)

        self.init_btn_connections()

方案2：切换面板时动态移动按钮到当前激活面板 #

利用QStackedWidget的currentChanged信号，在面板切换时将按钮从原布局移除，添加到当前激活面板的目标布局中。需要确保每个面板都有明确的布局位置来放置通用按钮。

修改UI类，添加面板切换处理逻辑：

class UI(QWidget, IO):
    def __init__(self, parent=None):
        QWidget.__init__(self)
        IO.__init__(self)

        layout = QVBoxLayout()
        self.stack = QStackedWidget()

        # 初始化面板并保存实例
        self.panel_a = PanelA()
        self.panel_b = PanelB()
        self.stack.addWidget(self.panel_a)
        self.stack.addWidget(self.panel_b)
        self.stack.setCurrentIndex(1)

        # 初始将按钮添加到当前面板的布局中
        self.current_target_layout = self.panel_b.findChild(QVBoxLayout)
        self.current_target_layout.addWidget(self.button)

        layout.addWidget(self.stack)
        self.setLayout(layout)

        self.init_btn_connections()
        # 监听面板切换事件
        self.stack.currentChanged.connect(self.on_panel_switched)

    def on_panel_switched(self, index):
        # 先将按钮从原布局中移除
        self.button.setParent(None)
        # 根据索引获取当前面板的目标布局
        if index == 0:
            target_layout = self.panel_a.findChild(QVBoxLayout)
        else:
            target_layout = self.panel_b.findChild(QVBoxLayout)
        # 将按钮添加到当前面板的布局
        target_layout.addWidget(self.button)

    def init_btn_connections(self):
        self.button.clicked.connect(lambda: self.btnstate(self.button))

    # 原btnstate方法保持不变

方案3：创建独立按钮复用逻辑 #

如果需要按钮在面板内保持一致的视觉位置，可以为每个面板创建独立的QPushButton实例，但通过统一的信号槽实现功能复用。这种方式避免了控件所有权问题，逻辑更清晰：

• 每个面板创建自己的QPushButton实例
• 所有按钮连接到同一个槽函数，实现通用逻辑
• 槽函数中可根据当前激活面板执行对应操作（如需）

核心原理说明 #

Qt中每个控件只能有一个父控件，直接将同一控件添加到多个布局会导致控件被自动从之前的父布局中移除，这是按钮仅在最后一个面板显示的根本原因。动态移动控件时，使用setParent(None)可安全将控件从原布局中移除，避免出现C++对象被意外删除的错误。

内容的提问来源于stack exchange，提问作者Michael