最近学习了视图(QGraphicsView)的知识,总结一下,做一个demo以备忘。在demo中演示了常用的设置方法和信号槽传递机制。
QT的视图(QGraphicsView)体系是建立在场景(QGraphicsScene)基础上的,场景(QGraphicsScene)是图形项(QGraphicsItem)的容器,图形项(QGraphicsItem)最终呈现的显示元素。
基本的框架演示:
# 设置样本图片的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.AlignmentFlag.AlignCenter) # 设置视图对齐方式if self.autoScale:self.fitInView(self.image_item, Qt.AspectRatioMode.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()函数执行之后就确定了视图的大小。