1.概要
2.内容
QGraphicsItem 的 contains 接口是一个虚函数，用于判断一个指定的点是否位于该图形项的边界矩形（bounding rectangle）内。这个函数通常用于实现鼠标事件处理、碰撞检测等功能。
函数原型如下：
virtual bool contains(const QPointF &point) const = 0;
point是一个QPointF类型的参数，表示要检查的点。- 返回值是一个布尔值，如果点位于图形项的边界矩形内，则返回
true；否则返回false。
由于 contains 是一个纯虚函数，因此在 QGraphicsItem 类中没有提供默认实现。这意味着当你创建自定义的图形项时，需要重写这个函数来提供你自己的实现。
在实现 contains 函数时，你通常会使用 boundingRect 函数返回的边界矩形来进行判断。例如，如果你的图形项是一个简单的矩形，你可能会这样实现 contains：
bool MyGraphicsItem::contains(const QPointF &point) const {
return boundingRect().contains(point);
}
然而，如果你的图形项有更复杂的形状，你可能需要使用 QPainterPath 来定义图形项的形状，并在 contains 函数中使用这个形状来进行判断。例如：
bool MyComplexGraphicsItem::contains(const QPointF &point) const {
return shape().contains(point);
}
在这个例子中，shape 函数返回一个 QPainterPath 对象，它描述了图形项的形状。然后，contains 函数使用这个形状来检查点是否位于图形项内。
总的来说，contains 函数是 QGraphicsItem 类中一个非常重要的接口，它允许你判断一个点是否位于图形项内，这对于实现交互功能（如鼠标点击、拖拽等）和碰撞检测非常有用。
3.关联链接
4.关联知识
1.QGraphicsItem详解
QGraphicsItem 是 Qt 图形视图框架（Graphics View Framework）中的核心类，用于表示场景（QGraphicsScene）中的图形项。它提供了灵活的 2D 图形项管理、绘制、事件处理和坐标变换等功能。以下是详细解析：
1. 核心功能
- 绘制：通过重写
paint()函数定义项的外观。 - 边界定义：通过
boundingRect()返回项的包围矩形（用于碰撞检测和渲染优化）。 - 形状定义：通过
shape()返回精确的碰撞检测形状（默认使用boundingRect()）。 - 事件处理：支持鼠标、键盘、悬停等事件（需重写
sceneEvent()或特定事件函数）。 - 变换：支持平移、旋转、缩放（通过
setTransform()或setPos()等）。 - 父子关系：支持父子项层级结构，子项坐标相对于父项。
- 标志位：通过
setFlags()控制项的行为（如是否可选、可移动）。
2. 关键函数
绘制与边界
-
paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)
重写此函数自定义绘制逻辑。需使用painter在项的局部坐标系中绘制。 -
QRectF boundingRect() const
定义项的包围矩形，用于碰撞检测和渲染优化。必须实现，且返回值需覆盖所有绘制内容。
形状与碰撞检测
QPainterPath shape() const
返回精确的碰撞检测形状（默认使用boundingRect()）。复杂的形状需手动定义以提高碰撞精度。
事件处理
-
void sceneEvent(QEvent *event)
集中处理所有事件（如鼠标、键盘事件）。需根据事件类型调用对应处理函数（如mousePressEvent）。 -
示例：处理鼠标事件
void MyItem::mousePressEvent(QGraphicsSceneMouseEvent *event) { qDebug() << "Mouse pressed at" << event->pos(); QGraphicsItem::mousePressEvent(event); }
变换与位置
void setPos(const QPointF &pos)：设置项的位置（局部坐标系原点）。void setRotation(qreal angle)：设置旋转角度（单位：度）。void setScale(qreal scale)：设置缩放比例。QTransform transform() const：获取项的变换矩阵。
标志位控制
setFlags(GraphicsItemFlags flags)
常用标志：ItemIsMovable：允许用户拖动项。ItemIsSelectable：允许选中项。ItemIgnoresTransformations：忽略视图变换（提升性能）。
3. 自定义 QGraphicsItem 步骤
-
继承
QGraphicsItemclass MyItem : public QGraphicsItem { public: QRectF boundingRect() const override { return QRectF(-50, -50, 100, 100); } void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget) override { painter->setBrush(Qt::blue); painter->drawEllipse(-50, -50, 100, 100); } }; -
添加到场景
MyItem *item = new MyItem; scene->addItem(item); -
处理事件（可选）
重写mousePressEvent、hoverEnterEvent等函数。
4. 高级用法
性能优化
- 减少
boundingRect()和paint()的计算量。 - 使用
ItemIgnoresTransformations标志：若项不受视图变换影响，可提升性能。 - 批量更新：通过
setPos()等函数移动项时，尽量合并多次操作为一次。
动画支持
- 使用
QVariantAnimation改变项的属性：QVariantAnimation *anim = new QVariantAnimation; anim->setTargetObject(item); anim->setPropertyName("pos"); anim->setStartValue(QPointF(0, 0)); anim->setEndValue(QPointF(100, 100)); anim->start();
组合项
- 使用
QGraphicsItemGroup将多个项组合为一个逻辑单元：QVariantAnimation *anim = new QVariantAnimation; anim->setTargetObject(item); anim->setPropertyName("pos"); anim->setStartValue(QPointF(0, 0)); anim->setEndValue(QPointF(100, 100)); anim->start();
5. 坐标系转换
-
场景坐标系：所有项的全局坐标系。
-
视图坐标系：视图的逻辑坐标系（受缩放、滚动影响）。
-
项坐标系：以项的原点
(0,0)为基准的局部坐标系。 -
常用转换函数：
mapToScene()：将项坐标转换为场景坐标。mapFromScene()：将场景坐标转换为项坐标。mapToItem()：将当前项坐标转换为另一项的坐标。
6. 示例：交互式矩形项
class DraggableRect : public QGraphicsRectItem {
public:
DraggableRect(qreal x, qreal y, qreal w, qreal h)
: QGraphicsRectItem(x, y, w, h) {
setFlag(QGraphicsItem::ItemIsMovable);
setBrush(Qt::yellow);
}
protected:
void mousePressEvent(QGraphicsSceneMouseEvent *event) override {
qDebug() << "Pressed at" << event->pos();
QGraphicsRectItem::mousePressEvent(event);
}
};
// 使用
DraggableRect *rect = new DraggableRect(0, 0, 100, 50);
scene->addItem(rect);
总结
QGraphicsItem 通过灵活的设计支持复杂的 2D 图形交互需求。关键点包括：
- 正确实现
boundingRect()和paint()。 - 利用标志位控制行为。
- 合理处理事件和坐标系转换。
- 结合
QGraphicsView和QGraphicsScene实现完整图形界面。
2.QGraphicsItem的contains应用举例
QGraphicsItem 的 contains() 方法用于判断一个点是否位于项的边界或形状内，常用于精确的事件处理（如鼠标点击检测）或碰撞检测。以下是应用举例和详细说明：
1. 默认行为
- 默认实现：
contains()默认使用shape()的返回值（若未重写则使用boundingRect()）判断点是否在项内。 - 局限性：若项的
boundingRect()比实际绘制区域大（如圆形），点击矩形边缘可能误判。
2. 应用场景
- 精确点击检测：确保只有点击图形内部时触发事件。
- 碰撞检测：判断两个复杂形状的项是否相交。
- 悬停效果：仅在鼠标进入图形内部时高亮。
3. 示例：圆形项的精确点击检测
步骤 1：继承 QGraphicsItem
#include <QGraphicsItem>
#include <QPainter>
class CircleItem : public QGraphicsItem {
public:
CircleItem(qreal radius, QGraphicsItem *parent = nullptr)
: m_radius(radius) {
setFlag(QGraphicsItem::ItemIsMovable); // 允许拖动
}
QRectF boundingRect() const override {
return QRectF(-m_radius, -m_radius, 2*m_radius, 2*m_radius);
}
void paint(QPainter *painter, const QStyleOptionGraphicsItem *, QWidget *) override {
painter->setBrush(Qt::blue);
painter->drawEllipse(-m_radius, -m_radius, 2*m_radius, 2*m_radius);
}
protected:
// 重写 contains() 实现精确检测
bool contains(const QPointF &point) const override {
// 计算点到圆心的距离
qreal dx = point.x();
qreal dy = point.y();
return (dx*dx + dy*dy) <= (m_radius * m_radius);
}
private:
qreal m_radius;
};
步骤 2：在事件处理中使用 contains()
void CircleItem::mousePressEvent(QGraphicsSceneMouseEvent *event) {
if (contains(event->pos())) {
qDebug() << "Clicked inside the circle!";
} else {
qDebug() << "Clicked outside the circle (but inside bounding rect).";
}
QGraphicsItem::mousePressEvent(event);
}
步骤 3：添加到场景
CircleItem *circle = new CircleItem(50);
scene->addItem(circle);
4. 关键说明
- 坐标系统：
event->pos()返回的是相对于项原点的局部坐标，可直接用于contains()。 - 性能优化：对于复杂形状，可预计算
QPainterPath并使用其contains()方法：QPainterPath m_path; // 在构造函数中初始化 m_path.addEllipse(-m_radius, -m_radius, 2*m_radius, 2*m_radius); bool contains(const QPointF &point) const override { return m_path.contains(point); } - 与碰撞检测结合：使用
collidesWithItem()时，若需精确检测，需同时重写contains()和shape()。
5. 效果对比
- 默认行为：点击圆形包围矩形（如边缘）会触发事件。
- 自定义 contains()：仅点击圆形内部时触发事件，提升交互精度。
通过重写 contains()，可以实现更精确的交互逻辑，适用于需要严格区分图形边界的场景。
扫一扫
1万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
