PyQt5自定义QWebEngineView Windows下绝对布局不显示问题咨询
问题根因排查
你之前的WebView组件无法在绝对布局下显示,核心是几个违反Qt控件渲染规则的问题,和是否依赖布局管理器没有直接关系:
- 最核心的疏漏:创建WebPage实例时没有指定父容器
按照Qt的对象树规则,所有需要内嵌在父窗口中的控件,必须在初始化时传入父窗口指针,否则创建出来的控件会被判定为独立的顶级窗口,不会出现在你的QDialog内容区内。哪怕你调用setGeometry,也只是设置这个独立浮窗的位置,很容易被主窗口完全遮挡,看起来就像组件根本没加载。
你之前用QGridLayout能正常显示,本质是布局管理器在添加控件时,会自动把控件的父对象设置为布局挂载的顶层容器,相当于自动补全了父子关系绑定,所以组件能正常渲染。你手写绝对定位的时候,刚好漏掉了这步绑定,才出现了组件不显示的问题。 - 位置参数设置错误:第二个WebView的几何坐标完全错配
你给web1设置的坐标和第一个web完全重叠在上半区,根本没有对应下半区box_url的位置,就算父对象设置正确,也会出现两个组件叠在一起、下半区空白的问题。 - 冗余占位组件遮挡:原本的两个
QTextBrowser是先创建的同级控件,会默认显示在上层,就算WebView位置对了,也会被不透明的TextBrowser完全盖住。
修正后的实现代码
from PyQt5 import QtCore, QtWidgets import sys from PyQt5.QtWidgets import QDialog, QApplication from PyQt5.QtWebEngineWidgets import QWebEngineSettings, QWebEngineView from PyQt5.QtCore import QUrl class WebPage(QWebEngineView): def load(self, url): self.setUrl(QUrl(url)) def adjustTitle(self): self.setWindowTitle(self.title()) def disableJS(self): settings = QWebEngineSettings.globalSettings() settings.setAttribute(QWebEngineSettings.JavascriptEnabled, False) class Page(QDialog): def __init__(self): super(Page, self).__init__() self.setObjectName("self") self.resize(582, 437) self.label_info = QtWidgets.QLabel(self) self.label_info.setGeometry(QtCore.QRect(40, 20, 100, 13)) self.label_info.setObjectName("label_info") # 去掉冗余的QTextBrowser占位组件,直接用WebPage替代对应区域 # 第一个WebPage 对应原box_info区域:显式传入self作为父容器 self.web = WebPage(self) self.web.load("https://i.picsum.photos/id/0/200/300.jpg?hmac=0pq7Zy79Vy4K-8w1qAMo1ppYmPvl-7lvwSx-LyZ7vNY") # 直接复用原box_info的几何参数定位 self.web.setGeometry(QtCore.QRect(40, 50, 231, 161)) self.web.setObjectName("url1") # 第二个WebPage 对应原box_url区域:显式传入self作为父容器 self.web1 = WebPage(self) self.web1.load("https://i.picsum.photos/id/0/200/300.jpg?hmac=0pq7Zy79Vy4K-8w1qAMo1ppYmPvl-7lvwSx-LyZ7vNY") # 修正坐标为原box_url的位置,不再和第一个WebView重叠 self.web1.setGeometry(QtCore.QRect(40, 230, 491, 151)) self.web1.setObjectName("url2") self.button_close = QtWidgets.QPushButton(self) self.button_close.setGeometry(QtCore.QRect(250, 400, 75, 23)) self.button_close.setObjectName("button_close") self.retranslateUi() QtCore.QMetaObject.connectSlotsByName(self) def retranslateUi(self): _translate = QtCore.QCoreApplication.translate self.setWindowTitle(_translate("Page", "Form")) self.label_info.setText(_translate("Page", "<html><head/><body><p><span style=\" font-size:10pt; font-weight:600;\">Info:</span></p></body></html>")) self.button_close.setText(_translate("Page", "Close")) if __name__ == '__main__': app = QApplication(sys.argv) page = Page() page.show() app.exec_()
绝对布局实现内嵌WebView的注意要点
- 所有要显示在父窗口内的子控件,必须通过构造参数或者
setParent()方法绑定父子关系,绝对不要创建无父对象的控件,否则会成为独立浮窗。 - 同一区域不要叠加多个不透明的同级控件,后创建的控件会在上层遮挡先创建的组件,冗余的占位控件要及时移除。
QWebEngineView是标准的QWidget子类,完全支持setGeometry的绝对定位逻辑,不需要依赖布局管理器就能正常渲染,之前的显示异常和组件本身无关。
内容的提问来源于stack exchange,提问作者dantix93
相关产品推荐
相关产品推荐

