当前位置：首页 > news >正文

PySide(PyQT)的视图（QGraphicsView）范例（一）基本框架

news 来源：原创 2025/9/9 11:47:53

最近学习了视图（QGraphicsView）的知识，总结一下，做一个demo以备忘。在demo中使用了场景（QGraphicsScene）、矩形框（QGraphicsRectItem）等构件，以及演示了常用的设置方法和信号槽传递机制。

基本的框架：

# 设置样本图片的QGraphicsView模型
from PySide6.QtCore import Qt, QRectF
from PySide6.QtGui import QPainter, QPen, QColor, QAction, QMouseEvent
from PySide6.QtWidgets import QGraphicsView, QGraphicsScene, QGraphicsPixmapItem, QGraphicsRectItem, QMenu, QWidget, \QVBoxLayout, QFrame, QSizePolicy# 设置矩形方框（QGraphicsRectItem）模型
class MyRectItem(QGraphicsRectItem):def __init__(self, temp_pen, normal_pen, *args):super().__init__(*args)self.temp_pen = temp_pen   # 临时画笔self.normal_pen = normal_pen   # 正常画笔# 启用鼠标跟踪，以便在没有按下鼠标按钮时也能接收鼠标移动事件self.setAcceptHoverEvents(True)def hoverEnterEvent(self, event: QMouseEvent):"""鼠标进入项的事件处理"""print("鼠标进入项")super().hoverEnterEvent(event)self.setPen(self.temp_pen)def hoverLeaveEvent(self, event: QMouseEvent):"""鼠标离开项的事件处理"""print("鼠标离开项")super().hoverLeaveEvent(event)self.setPen(self.normal_pen)# 设置QGraphicsView模型
class MyView(QGraphicsView):def __init__(self, parent=None, autoScale=True):super().__init__(parent)self.autoScale = autoScale  # 自动缩放标志，是否全画幅显示self.set_scene()   # 设置场景self.set_mouse()   # 设置鼠标self.set_flags()   # 设置标志self.set_menu()   # 设置菜单def set_scene(self):"""设置场景"""self.scene = QGraphicsScene()  # 创建窗口场景# 设置渲染提示self.setRenderHint(QPainter.Antialiasing)  # 开启抗锯齿self.setRenderHint(QPainter.SmoothPixmapTransform)  # 开启平滑缩放# 设置缩放锚点self.setTransformationAnchor(QGraphicsView.AnchorUnderMouse)  # 转换时以鼠标为中心self.setResizeAnchor(QGraphicsView.AnchorUnderMouse)  # 缩放时以鼠标为中心self.setScene(self.scene)  # 将场景应用到视窗中def set_mouse(self):"""设置鼠标"""self.setMouseTracking(True)  # 设置鼠标跟踪# 鼠标的实时位置（视窗坐标）self.view_x = 0self.view_y = 0# 鼠标的实时位置（场景坐标）self.scene_x = 0self.scene_y = 0# 鼠标按下时的位置（场景坐标）self.press_x = Noneself.press_y = None# 鼠标释放时的位置（场景坐标）self.release_x = 0self.release_y = 0# 处理滚轮事件以实现缩放def wheelEvent(self, event):"""处理滚轮事件以实现缩放"""factor = 1.001 ** event.angleDelta().y()  # 滚轮每滚动一格，缩放比例变化self.scale(factor, factor)def set_flags(self):"""设置标志"""passdef set_menu(self):"""设置菜单"""pass# 设置图像文件def set_image(self, pixmap):self.scene.clear()  # 清空场景self.scene_rect = QRectF(0, 0, pixmap.width(), pixmap.height())  # 设置场景范围self.image_item = QGraphicsPixmapItem(pixmap)  # 创建图片对象self.scene.addItem(self.image_item)  # 将图片对象添加到场景中self.setAlignment(Qt.AlignCenter)  # 设置视图对齐方式if self.autoScale:self.fitInView(self.image_item, Qt.KeepAspectRatio)  # 设置视图适应图片，全幅显示if __name__ == "__main__":import sysfrom PySide6.QtWidgets import QApplicationfrom PySide6.QtGui import QPixmapapp = QApplication(sys.argv)widget = QWidget()  # 创建窗口对象widget.resize(800, 600)  # 设置窗口大小widget.layout = QVBoxLayout(widget)  # 创建垂直布局对象widget.view = MyView(widget)  # 创建MyView对象widget.layout.addWidget(widget.view)  # 将视图添加到布局中pixmap = QPixmap("your/image/path")  # 创建QPixmap对象widget.show()  # 显示窗口widget.view.set_image(pixmap)  # 设置图像文件sys.exit(app.exec())  # 进入程序的主循环，并通过exit()函数确保主循环安全结束

基本框架具备了图像显示和鼠标滚轮缩放的功能：

注意：

widget.show()  # 显示窗口
widget.view.set_image(pixmap)  # 设置图像文件

这两行代码的顺序一定不能反，如果将 widget.show() 放在widget.view.set_image(pixmap)后面，将会是下面的显示效果，初始化后不能全幅显示。

这是因为 fitInView 方法的行为依赖于视图的实际大小，而在窗口尚未显示时，视图的大小可能是未确定的或者是默认值，从而导致 fitInView 无法正确计算和应用缩放，而show()函数执行之后就确定了视图的大小。

相关文章：