QT之QGraphicsPixmapItem详细介绍

此篇文章来源于自己在完成一个图片编辑软件而遇到的三个类：QGraphicsScene、QGraphicsPixmapItem、QGraphicsView。此篇文章先介绍QGraphicsPixmapItem，另外两个类在其他文章，大家可查看博主其他文章。本人能力有限，大家有任何问题可评论区评论，共同学习，共同进步。

一、QGraphicsPixmapItem介绍

QGraphicsPixmapItem 是 Qt 框架中的一个类，它是 QGraphicsItem 类的一个派生类，专为在 QGraphicsScene 中显示和操作像素图（即 QPixmap 对象）而设计。它主要用于在图形视图体系结构（Graphics View Framework）中呈现静态或动态的图像资源。

主要特性及用途：

1. 显示图像：

   • 可以通过构造函数传递一个 QPixmap 对象创建 QGraphicsPixmapItem 实例，并将其添加到 QGraphicsScene 中显示图像。
   • 也可以在对象创建后使用 setPixmap(const QPixmap &) 方法动态改变显示的图像。

2. 变换与定位：

   • 可以对 QGraphicsPixmapItem 进行平移、旋转和缩放等几何变换。
   • 使用 setPos()、setRotation()、setScale() 等方法来调整其在场景中的位置、旋转角度和缩放比例。

3. 形状与掩模：

   • 通过 setShapeMode() 函数设置形状模式，比如 QGraphicsPixmapItem::MaskShape，这样可以利用 QPixmap 的掩模信息定义项目本身的形状和透明度。

4. 碰撞检测与交互：

   • 默认情况下，碰撞检测基于整个像素图的边界，但也支持自定义形状，以便更精确地响应用户交互和场景中的其他图形项。
   • 可以处理鼠标事件，如点击、移动等，从而实现拖动、选择等功能。

5. 透明度支持：

   • 可以设置 QGraphicsPixmapItem 的不透明度，使得所显示的图像具有透明效果。

6. 层次关系：

   • 在图形视图中，QGraphicsPixmapItem 可以和其他图形项一样，参与场景的层次管理，可以通过 setZValue() 方法调整其在垂直方向上的叠放顺序。

总之，QGraphicsPixmapItem 是在图形视图框架中处理图像显示的核心组件，广泛应用于各种桌面应用程序的图形化界面构建，尤其在需要动态显示和操作图像的场合下非常有用。

关于QGraphicsItem 之后在其他文章进行介绍

二、成员函数

1、QGraphicsPixmapItem::QGraphicsPixmapItem(const QPixmap &pixmap, QGraphicsItem *parent = nullptr)

QGraphicsPixmapItem::QGraphicsPixmapItem(const QPixmap &pixmap, QGraphicsItem *parent = nullptr) 是 QGraphicsPixmapItem 类的一个构造函数。这个构造函数用于创建一个新的 QGraphicsPixmapItem 对象，并初始化它来显示给定的 QPixmap 图像。

参数说明：

• const QPixmap &pixmap：一个 QPixmap 对象引用，它包含了要在 QGraphicsPixmapItem 中显示的图像数据。
• QGraphicsItem *parent = nullptr：一个指向 QGraphicsItem 类型的指针，表示新建的 QGraphicsPixmapItem 的父项。如果提供了父项，那么新创建的 QGraphicsPixmapItem 将成为该父项的孩子节点，并遵循图形视图中的父子关系规则，如布局、变换和事件处理等。如果未提供父项，则该图形项将成为场景的顶层项。

示例代码：

// 创建一个 QPixmap 对象
QPixmap pixmap("image.jpg");

// 使用构造函数创建一个 QGraphicsPixmapItem 对象，并设置其显示的图像
QGraphicsPixmapItem *pixmapItem = new QGraphicsPixmapItem(pixmap);

// 将该图形项添加到 QGraphicsScene 中
QGraphicsScene *scene = new QGraphicsScene();
scene->addItem(pixmapItem);

// 将 QGraphicsScene 显示在 QGraphicsView 中
QGraphicsView *view = new QGraphicsView(scene);
view->show();

在这段代码中，我们首先创建了一个 QPixmap 对象，然后使用 QGraphicsPixmapItem 构造函数创建了一个新的图形项，并将其关联到先前创建的 QPixmap 对象上。随后，我们将这个图形项添加到场景中，并通过 QGraphicsView 显示出来。

2、QGraphicsPixmapItem::QGraphicsPixmapItem(QGraphicsItem *parent = nullptr)

QGraphicsPixmapItem::QGraphicsPixmapItem(QGraphicsItem *parent = nullptr) 是 QGraphicsPixmapItem 类的另一个构造函数，用于创建一个新的 QGraphicsPixmapItem 对象，但不立即为其分配任何图像（QPixmap）。

参数说明：

• QGraphicsItem *parent = nullptr：一个指向 QGraphicsItem 类型的指针，表示新建的 QGraphicsPixmapItem 的父项。如果提供了父项，那么新创建的 QGraphicsPixmapItem 将成为该父项的孩子节点，并遵循图形视图中的父子关系规则，如布局、变换和事件处理等。如果未提供父项，则该图形项将成为场景的顶层项。

使用这个构造函数创建的 QGraphicsPixmapItem 初始时并没有显示任何图像，需要通过调用 setPixmap(const QPixmap &) 方法来设置显示的图像。

示例代码：

// 使用无参构造函数创建一个 QGraphicsPixmapItem 对象
QGraphicsPixmapItem *pixmapItem = new QGraphicsPixmapItem(nullptr);

// 加载一个 QPixmap 图像
QPixmap pixmap("image.jpg");

// 为已创建的 QGraphicsPixmapItem 设置图像
pixmapItem->setPixmap(pixmap);

// 将该图形项添加到 QGraphicsScene 中
QGraphicsScene *scene = new QGraphicsScene();
scene->addItem(pixmapItem);

// 将 QGraphicsScene 显示在 QGraphicsView 中
QGraphicsView *view = new QGraphicsView(scene);
view->show();

这段代码首先使用无参构造函数创建了一个空的 QGraphicsPixmapItem，然后加载了一个 QPixmap 图像，并通过 setPixmap() 方法将图像设置到该图形项上。后续步骤同上，将图形项添加到场景并通过视图显示。

3、QGraphicsPixmapItem::~QGraphicsPixmapItem()

QGraphicsPixmapItem::~QGraphicsPixmapItem() 是 QGraphicsPixmapItem 类的析构函数。在C++中，析构函数是一种特殊的成员函数，当