QGraphicsScene

原创已于 2024-11-07 11:50:26 修改 · 364 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#qt

于 2024-09-01 14:41:21 首次发布

qt-二维绘图专栏收录该内容

58 篇文章

订阅专栏

QGraphicsScene是Qt框架中用于管理2D图形项(QGraphicsItem)的容器类。以下是关于QGraphicsScene的一些关键信息和功能：

坐标系统：
- QGraphicsScene使用自己的坐标系统来定义图形项的位置和布局。
- 坐标系统的原点(0,0)通常位于场景的左上角。
- 当向场景中添加图形项（如QGraphicsRectItem）时，需要指定图形项在场景坐标中的位置和大小。
图形项管理：
- 可以向QGraphicsScene中添加、删除和管理多个QGraphicsItem对象，例如矩形、椭圆、文本等。
- 使用addItem方法添加图形项，removeItem方法删除图形项。
事件处理：
- QGraphicsScene能够处理如鼠标点击和键盘输入等事件，这些事件可以被传递给场景中的图形项进行处理。
渲染与视图：
- QGraphicsScene负责管理图形项的渲染，与QGraphicsView配合，后者负责将场景内容映射到窗口坐标系统并显示出来。
- 视图可以处理缩放、旋转或平移等变换，影响用户在视图中看到的坐标。
优化与性能：
- QGraphicsScene实现了一些优化机制，以提高包含大量图形项的场景的绘制性能。
交互功能：
- 支持图形项的选择、焦点管理以及碰撞检测等交互功能。

总的来说，QGraphicsScene提供了一个灵活且强大的2D图形管理环境，使得开发者能够轻松地创建复杂的图形界面并实现丰富的交互效果。它是Qt图形框架中的重要组成部分，为构建具有视觉吸引力的用户界面奠定了基础。如果需要更详细或最新的信息，建议查阅Qt的官方文档或相关开发社区。

QGraphicsScene常用接口

QGraphicsScene是Qt中用于管理2D图形项的核心类，它提供了丰富的功能和灵活的接口，使得开发者能够方便地创建复杂的2D图形界面并实现各种交互效果和动画。QGraphicsScene的常用接口包括但不限于以下几种：

一、图形项管理

addItem：向场景中添加一个图形项。如果该项在其他场景中，它将会先从旧的场景中删除，再添加到当前场景中。
removeItem：从场景中删除指定的图形项。
addEllipse, addLine, addPath, addPixmap, addPolygon, addRect, addText, addWidget：这些接口用于创建并添加特定类型的图形项到场景中，如椭圆、路径、图片、矩形、多边形、文本和窗口小部件。
items和itemAt：items返回场景中所有图形项的列表，而itemAt返回指定位置最顶层的图形项。

二、场景属性设置

setSceneRect：手动设置场景的边界。如果没有明确设置，场景将根据其包含的图形项尺寸自动计算边界，但这可能会比较耗时。
setBackgroundBrush和setForegroundBrush：这两个接口分别用于设置场景的背景和前景填充色，从而控制场景的视觉表现。
setFont：为场景设置默认的字体，这将影响场景中所有文本项的字体样式。

三、选择和焦点管理

setSelectionArea和clearSelection：setSelectionArea允许你选择场景中特定区域的图形项，而clearSelection则用于清除所有已选中的图形项。
setFocusItem和focusItem：通过调用setFocusItem()为一个图形项设置焦点，或者通过focusItem()来获取当前获得焦点的图形项。

四、渲染和事件处理

render：将场景中的一部分渲染到绘图设备上。
事件处理函数：如mousePressEvent()、keyPressEvent()等，用于处理来自鼠标和键盘的事件。
碰撞检测：虽然直接的碰撞检测接口在QGraphicsScene中并不明显，但可以通过获取图形项的位置和边界（如使用boundingRect方法），然后手动进行碰撞计算。此外，QGraphicsScene的collidingItems方法可以用于查找与指定图形项碰撞的所有其他图形项。

五、其他接口

changed()信号：当场景内容发生变化时发出此信号。
focusItemChanged()信号：当场景的焦点项发生变化时发出此信号。

这些接口和功能使得QGraphicsScene成为Qt图形框架中一个强大而灵活的工具，能够支持复杂的2D图形界面和丰富的交互效果。请注意，以上列举的接口可能不是全部，建议查阅Qt官方文档以获取最全面和最新的信息。

QGraphicsScene应用举例

QGraphicsScene是Qt框架中用于创建和管理2D图形界面的重要工具。以下是一个简单的应用举例，展示如何使用QGraphicsScene来创建和管理图形项。

1. 创建一个简单的QGraphicsScene应用

步骤一：包含必要的头文件

#include <QApplication>
#include <QGraphicsView>
#include <QGraphicsScene>
#include <QGraphicsRectItem>

步骤二：创建QApplication对象

QApplication对象管理应用程序的控制流和主要设置。

int main(int argc, char* argv[]) {
    QApplication app(argc, argv);

步骤三：创建QGraphicsScene对象

QGraphicsScene是图形项的容器，可以管理多个QGraphicsItem对象。

QGraphicsScene scene;

步骤四：在场景中添加图形项

这里添加一个蓝色填充、黑色边框的矩形。

QGraphicsRectItem* rect = scene.addRect(0, 0, 100, 100, QPen(Qt::black), QBrush(Qt::blue));

步骤五：创建QGraphicsView对象并设置场景

QGraphicsView是视图部件，用于可视化场景中的内容。

QGraphicsView view(&scene);

步骤六：显示视图

调用show()方法显示视图，这样用户就能通过视图看到并可能与场景中的图形项进行交互。

view.show();

步骤七：进入应用程序的事件循环

return app.exec();
}

2. 完整代码示例

#include <QApplication>
#include <QGraphicsView>
#include <QGraphicsScene>
#include <QGraphicsRectItem>

int main(int argc, char* argv[]) {
    QApplication app(argc, argv); // 创建QApplication对象

    QGraphicsScene scene; // 创建QGraphicsScene对象

    QGraphicsRectItem* rect = scene.addRect(0, 0, 100, 100, QPen(Qt::black), QBrush(Qt::blue)); // 在场景中添加图形项

    QGraphicsView view(&scene); // 创建QGraphicsView对象并设置场景

    view.show(); // 显示视图

    return app.exec(); // 进入应用程序的事件循环
}

3. 应用说明

在这个示例中，我们首先创建了一个QGraphicsScene对象，并在其上添加了一个蓝色填充、黑色边框的矩形。
然后，我们创建了一个QGraphicsView对象，并将其与场景关联起来。
最后，通过调用show()方法显示视图，使得用户能够通过视图看到并可能与场景中的图形项进行交互。

这个简单的应用举例展示了QGraphicsScene的基本用法，包括创建场景、添加图形项、创建视图以及显示视图。通过扩展这个基本框架，可以开发出更加复杂和功能丰富的2D图形应用程序。

QGraphicsScene的选择和焦点管理

QGraphicsScene在Qt框架中扮演着管理2D图形项（QGraphicsItem）的重要角色，其中选择和焦点管理是其核心功能之一。以下是对QGraphicsScene选择和焦点管理的详细阐述：

一、选择管理

QGraphicsScene支持图形项的选择功能，允许用户通过鼠标或键盘选择场景中的图形项，并对它们进行操作。以下是一些关键的选择管理接口和特性：

setSelectionArea：此方法允许用户定义一个选择区域，场景会自动选择该区域内的所有图形项。这通常与橡皮筋选择功能配合使用，即用户在视图中拖动鼠标以定义一个选择矩形，然后释放鼠标时，场景会选择该矩形内的所有图形项。
selectedItems：此方法返回一个列表，包含当前所有被选中的图形项。这允许开发者遍历这些项并对其进行进一步的操作。
clearSelection：此方法用于清除当前所有的选择状态，即取消选择场景中的所有图形项。
selectionChanged信号：当场景中的选择发生变化时（例如，图形项被选中或取消选中），此信号会被发出。开发者可以连接此信号到一个槽函数，以响应选择的变化。

二、焦点管理

焦点管理允许场景中的图形项接收键盘输入事件。以下是一些关键的焦点管理接口和特性：

setFocusItem：此方法允许开发者为场景中的特定图形项设置焦点。当图形项获得焦点时，它将能够接收键盘输入事件。
focusItem：此方法返回当前具有焦点的图形项。如果没有图形项具有焦点，则返回nullptr。
focusItemChanged信号：当场景中的焦点项发生变化时（例如，一个图形项失去焦点，另一个图形项获得焦点），此信号会被发出。开发者可以连接此信号到一个槽函数，以响应焦点的变化。
focusNextPrevChild：此方法允许开发者通过键盘的Tab和Shift+Tab键在场景中的图形项之间移动焦点。它接受一个布尔参数，指示焦点是向前（true）还是向后（false）移动。

三、选择和焦点管理的重要性

选择和焦点管理在Qt的Graphics View框架中扮演着至关重要的角色。它们允许用户与场景中的图形项进行交互，选择特定的项并对其进行操作，同时也支持通过键盘进行导航和输入。这些功能使得Graphics View框架能够创建出丰富、动态且用户友好的2D图形界面。

四、实际应用场景

在实际应用中，选择和焦点管理可以用于多种场景，例如：

图形编辑器：在图形编辑器中，用户可能需要选择多个图形项以进行编辑、移动或删除。焦点管理则允许用户通过键盘快捷键对选中的图形项进行操作。
数据可视化工具：在数据可视化工具中，用户可能需要选择特定的数据点或图形元素以查看详细信息或进行交互。选择和焦点管理提供了直观且高效的方式来实现这一功能。
游戏开发：在游戏开发中，选择和焦点管理可以用于实现角色选择、物品交互等功能。通过键盘和鼠标的结合使用，玩家可以轻松地与游戏世界中的元素进行交互。

总之，QGraphicsScene的选择和焦点管理功能为开发者提供了强大的工具来创建具有丰富交互性和用户友好性的2D图形应用程序。

QGraphicsScene获取选中的图形列表

在QGraphicsScene中，要获取当前选中的图形项列表，可以使用selectedItems()方法。该方法会返回一个QList<QGraphicsItem*>，包含场景中所有当前被选中的图形项。

以下是一个简单的示例，演示了如何使用selectedItems()方法：

#include <QGraphicsScene>
#include <QGraphicsView>
#include <QGraphicsRectItem>
#include <QList>
#include <QDebug>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    // 创建QGraphicsScene对象
    QGraphicsScene scene;

    // 在场景中添加一个矩形图形项
    QGraphicsRectItem *rect = scene.addRect(0, 0, 100, 100, QPen(Qt::black), QBrush(Qt::blue));

    // 创建QGraphicsView对象并设置场景
    QGraphicsView view(&scene);

    // 显示视图
    view.show();

    // 假设用户通过某种方式（如鼠标点击）选中了矩形图形项
    // 在实际应用中，这通常是通过QGraphicsView的交互来实现的

    // 获取当前选中的图形项列表
    QList<QGraphicsItem*> selectedItems = scene.selectedItems();

    // 遍历并打印选中项的信息
    foreach(QGraphicsItem *item, selectedItems) {
        qDebug() << "Selected item:" << item;
    }

    return app.exec();
}

在这个示例中，我们首先创建了一个QGraphicsScene对象，并在其上添加了一个矩形图形项。然后，我们创建了一个QGraphicsView对象，并将其与场景关联起来。接下来，假设用户通过某种方式（如鼠标点击）选中了矩形图形项（在实际应用中，这通常是通过QGraphicsView的交互来实现的）。最后，我们使用selectedItems()方法获取当前选中的图形项列表，并遍历该列表打印每个选中项的信息。

请注意，在实际应用中，用户通常是通过QGraphicsView的交互（如鼠标点击）来选择场景中的图形项的。QGraphicsView提供了各种交互功能，如鼠标点击选择、橡皮筋选择等，这些交互会自动更新场景中的选择状态。因此，在获取选中项列表之前，通常不需要手动设置选中项，除非有特定的需求需要通过编程方式来实现选择。