QAxWidget失去焦点时内容消失的解决方法及技术资料求助

问题描述 #

使用Python+PyQt5开发Windows平台GUI，通过QAxWidget嵌入PowerPoint演示文稿，功能整体正常，但存在异常：QAxWidget失去焦点时，PPT内容会消失，点击控件后才恢复显示。已尝试setFocus()方法无效，且相关开发书籍缺乏ActiveX/QAxWidget的针对性内容，仅能参考C++官方文档和论坛帖子。

复现代码 #

import sys

from PyQt5.QAxContainer import QAxWidget
from PyQt5.QtCore import QEvent
from PyQt5.QtWidgets import QWidget, QVBoxLayout, QPushButton, QApplication, QMainWindow


class MainWindow(QMainWindow):

    def __init__(self):
        super().__init__()

        self.menuBar().addMenu("&About")

        self.centralwidget = QWidget(self)
        self.centralwidget_vlayout = QVBoxLayout(self.centralwidget)

        self.axwidget = QAxWidget(self.centralwidget)
        self.axwidget.installEventFilter(self)
        self.axwidget.setControl(r"C:\path\to\presentation.pptx")

        self.pushbutton = QPushButton(self.centralwidget)
        self.pushbutton.setText("Press me!")

        self.centralwidget_vlayout.addWidget(self.axwidget)
        self.centralwidget_vlayout.addWidget(self.pushbutton)

        self.setCentralWidget(self.centralwidget)

        self.show()

    def eventFilter(self, widget: QWidget, event: QEvent):
        if event.type() == QEvent.Resize and widget is self.axwidget:
            self.axwidget.setFixedHeight(int(self.axwidget.width() / 16 * 9))

        return super(MainWindow, self).eventFilter(widget, event)


if __name__ == '__main__':
    app = QApplication(sys.argv)
    mainWin = MainWindow()
    sys.exit(app.exec())

解决方案 #

该问题源于Qt的QAxWidget与PowerPoint ActiveX控件的焦点/重绘机制冲突，可通过以下方式解决：

方法1：窗口激活状态变化时强制重绘 #

在MainWindow类中添加窗口状态变化事件处理，触发QAxWidget重绘：

from PyQt5.QtCore import QEvent

def changeEvent(self, event):
    if event.type() == QEvent.ActivationChange:
        self.axwidget.update()
    super().changeEvent(event)

方法2：调整焦点策略+控件交互时重绘 #

修改QAxWidget的焦点策略，并在其他控件交互时主动触发重绘：

from PyQt5.QtCore import Qt

# 在__init__中添加
self.axwidget.setFocusPolicy(Qt.StrongFocus)
self.pushbutton.clicked.connect(lambda: self.axwidget.repaint())

方法3：通过Windows API强制重绘 #

若上述方法无效，可调用Windows API直接发送重绘消息：

from ctypes import windll, c_int

# 在MainWindow类中添加方法
def force_redraw(self):
    hwnd = self.axwidget.winId()
    # 发送重绘和刷新背景的消息
    windll.user32.RedrawWindow(c_int(hwnd), None, None, 0x0001 | 0x0080)

# 在changeEvent中调用
def changeEvent(self, event):
    if event.type() == QEvent.ActivationChange:
        self.force_redraw()
    super().changeEvent(event)

补充资料参考方向 #

• Qt官方C++文档中QAxWidget类的详细说明
• Qt论坛中关于ActiveX控件嵌入的技术讨论
• Microsoft Office Automation文档（PowerPoint作为ActiveX控件的接口规范）

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