如何将自定义Python PDFViewer嵌入PyQt5主窗口？

你遇到的问题核心是这个PDFViewer是基于tkinter框架开发的，并非Qt部件，直接传入setCentralWidget会导致tk和Qt各自启动独立的GUI事件循环，最终出现两个分离的窗口。以下是两种可行的解决方案：

方案一：将tkinter窗口嵌入Qt容器 #

利用Qt的窗口句柄转换能力，把tkinter窗口包装成Qt部件后嵌入，代码修改如下：

import sys
import tkinter as tk
from view import PDFViewer
from PyQt5 import QtCore, QtWidgets, QtGui

class MainWindow(QtWidgets.QMainWindow):
    def __init__(self, *args, **kwargs):
        super(MainWindow, self).__init__(*args, **kwargs)
        # 初始化tkinter并隐藏默认根窗口
        root = tk.Tk()
        root.withdraw()
        
        # 创建PDFViewer实例
        pdf_viewer = PDFViewer()
        # 获取tk窗口的系统句柄并转换为Qt窗口对象
        tk_win_id = pdf_viewer.winfo_id()
        qt_win = QtGui.QWindow.fromWinId(tk_win_id)
        # 将Qt窗口包装为可嵌入的Qt部件
        container = QtWidgets.QWidget.createWindowContainer(qt_win, self)
        
        self.setCentralWidget(container)
        self.show()

app = QtWidgets.QApplication(sys.argv)
w = MainWindow()
app.exec_()

注意：跨框架嵌入可能存在事件响应延迟、样式不统一等兼容性问题，仅适合临时场景。

方案二：使用Qt原生组件实现PDF查看（推荐） #

放弃跨框架的tkinter组件，改用Qt生态内的方案，稳定性和兼容性更好，推荐两种实现方式：

方式1：用QWebEngineView直接加载PDF #

Qt的WebEngine组件支持原生渲染PDF，代码示例：

import sys
from PyQt5 import QtWidgets, QtWebEngineWidgets

class MainWindow(QtWidgets.QMainWindow):
    def __init__(self, pdf_path, *args, **kwargs):
        super(MainWindow, self).__init__(*args, **kwargs)
        pdf_view = QtWebEngineWidgets.QWebEngineView()
        # 替换为你的本地PDF文件路径
        pdf_view.load(QtCore.QUrl.fromLocalFile(pdf_path))
        self.setCentralWidget(pdf_view)
        self.show()

if __name__ == "__main__":
    app = QtWidgets.QApplication(sys.argv)
    w = MainWindow("your_pdf_file.pdf")
    app.exec_()

方式2：用PyMuPDF结合Qt自定义渲染 #

PyMuPDF（fitz）是轻量PDF处理库，可将PDF页面渲染为Qt图片后展示，适合需要自定义交互的场景：

import sys
import fitz
from PyQt5 import QtWidgets, QtGui, QtCore

class PDFViewer(QtWidgets.QScrollArea):
    def __init__(self, pdf_path, parent=None):
        super().__init__(parent)
        self.pdf_doc = fitz.open(pdf_path)
        self.content_widget = QtWidgets.QWidget()
        self.layout = QtWidgets.QVBoxLayout(self.content_widget)
        self.setWidget(self.content_widget)
        self.setWidgetResizable(True)
        self.render_all_pages()
    
    def render_all_pages(self):
        for page_num in range(self.pdf_doc.page_count):
            page = self.pdf_doc.load_page(page_num)
            pix = page.get_pixmap()
            # 将fitz图片转换为Qt图像格式
            img = QtGui.QImage(pix.samples, pix.width, pix.height, pix.stride, QtGui.QImage.Format_RGB888)
            page_label = QtWidgets.QLabel()
            page_label.setPixmap(QtGui.QPixmap.fromImage(img))
            self.layout.addWidget(page_label)

class MainWindow(QtWidgets.QMainWindow):
    def __init__(self, pdf_path, *args, **kwargs):
        super().__init__(*args, **kwargs)
        viewer = PDFViewer(pdf_path)
        self.setCentralWidget(viewer)
        self.show()

if __name__ == "__main__":
    app = QtWidgets.QApplication(sys.argv)
    w = MainWindow("your_pdf_file.pdf")
    app.exec_()

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