理解 QGraphicsScene 的核心角色

在 Qt 框架的图形视图体系中，QGraphicsScene 扮演着至关重要的“舞台”或“场景”角色。

它本身是一个不可见的容器，负责管理和维护一个由众多图形项构成的场景。这些图形项可以是简单的几何形状、文本，甚至是复杂的自定义控件。

与直接在主窗口上绘制不同，QGraphicsScene 提供了一个逻辑上的二维坐标系平面。所有图形项都在这个平面上进行放置、变换和交互。

它为开发者处理了大量底层工作，例如：

• 项的选择与焦点管理
• 碰撞检测
• 场景的更新与渲染区域优化

理解其作为“项管理器”和“坐标系提供者”的双重身份，是掌握其用法的第一步。

创建场景与设置基本属性

使用 QGraphicsScene 的第一步是创建其实例。

通常，在构建界面时，我们会将其与一个 QGraphicsView 视图关联。视图负责将场景的内容可视化呈现给用户。

创建时可以指定场景的初始逻辑边界。例如：

• new QGraphicsScene(0, 0, 800, 600) 将创建一个左上角在 (0,0)，宽800、高600的初始场景矩形。

当然，场景的边界是动态的，可以随着其中图形项的增减而自动调整。

创建后，可以设置场景的各种属性：

• 通过 setBackgroundBrush() 方法设置背景颜色或背景画刷。
• 也可以设置前景颜色。

此外，场景还管理着选择模式、鼠标交互行为等全局设置。这些初始配置为后续添加图形项奠定了基础。

向场景中添加图形项

场景搭建好后，核心操作便是向其中填充内容。

Qt 提供了一系列内置的 QGraphicsItem 派生类：

• QGraphicsRectItem（矩形）
• QGraphicsEllipseItem（椭圆）
• QGraphicsTextItem（文本）
• QGraphicsPixmapItem（图像）等。

添加项非常简单：

• 通常使用 QGraphicsScene::addItem() 方法。
• 或直接使用场景提供的便捷函数，如 addRect()、addEllipse()。这些函数会创建并返回对应的图形项指针。

每个图形项都可以设置独立的属性：

• 几何属性（位置、旋转、缩放）
• 画笔（Pen，用于轮廓）
• 画刷（Brush，用于填充）
• Z 值（用于控制叠放顺序）

通过将这些项添加到场景，它们便进入了场景的管理体系，可以参与后续的交互和事件处理。

实现视图与场景的交互

单独的 QGraphicsScene 无法显示，必须通过 QGraphicsView 来查看。

将视图与场景关联使用 QGraphicsView::setScene() 方法。

视图如同一个观察场景的“窗口”或“摄像机”。它支持平移、缩放等操作，允许用户浏览大于视图窗口的场景区域。

在教程实践中，通常需要实现一些基础交互：

• 通过重写视图或场景的事件处理函数，来响应鼠标点击以选择或移动图形项。
• 利用场景的信号（如 selectionChanged()）来感知项的选择状态变化。
• 通过视图的变换功能实现场景的缩放与平移。这可以通过设置视图的变换矩阵或直接调用 scale()、translate() 等方法完成。

理解视图-场景-项三者之间的事件传递流程，是实现复杂交互的关键。

组织与管理复杂场景

当场景中的图形项数量增多、关系复杂时，有效的组织管理策略显得尤为重要。

QGraphicsScene 本身提供了按位置查找项的函数（如 items()）。这对于实现碰撞检测或区域选取非常有用。

此外，可以通过将相关图形项进行分组，使用 QGraphicsItemGroup 来将它们作为一个整体进行操作。

对于需要动态更新或具有复杂行为的项，自定义 QGraphicsItem 子类是更强大的手段。

在自定义项中，可以：

• 重写 paint() 函数来定义绘制逻辑。
• 重写 boundingRect() 来定义项的边界。
• 重写鼠标和键盘事件处理器来实现自定义交互。

同时，需要注意性能优化：

• 对于静态背景和动态前景进行分层管理。
• 仅在必要时更新场景的特定区域，以避免不必要的重绘开销。

《夸克》非常好用的免费AI浏览器

下载APP查看