简述

由于 QGraphicsScene 和 QGraphicsItem 的大多数便利函数例如items()selectedItems()、collidingItems()、childItems()返回一个 QList<QGraphicsItem *> 列表在遍历列表的时候通常需要对其中的 QGraphicsItem 进行类型检测与转换以确定实际的 item。

简述 类型检测 QGraphicsItemTypeQGraphicsItemUserType类型转换实际应用

类型检测

QGraphicsItem 中包含两个与类型相关的枚举值

enum { Type = 1, UserType = 65536 };

QGraphicsItem::Type

QGraphicsItem::Type 是标准 item 类中 virtual type() 函数返回的类型值。所有标准 item 与唯一的 Type 值相关联。例如QGraphicsPathItem::type() 返回的值为 2。

class QGraphicsPathItem : public QAbstractGraphicsShapeItem { public: enum { Type = 2 }; int type() const { return Type; } ... };

其他标准 item 类似Type 分别为 3、4、5……

QGraphicsItem::UserType

QGraphicsItem::UserType 是自定义 itemQGraphicsItem 或任何标准 item 的子类的最小允许类型值。该值与 QGraphicsItem::type() 的重新实现结合使用并声明一个 Type 枚举值。例如

class CustomItem : public QGraphicsItem { public: enum { Type = UserType + 1 }; int type() const { // 针对该 item 启用 qgraphicsitem_cast return Type; } ... };

注意要使 qgraphicsitem_cast 与自定义 item 一起正常工作需要为其重新实现 type() 函数。

类型转换

T qgraphicsitem_cast(QGraphicsItem *item)

如果 item 是类型 T返回指定 item 转换为类型 T否则返回 0。

template <class T> inline T qgraphicsitem_cast(const QGraphicsItem *item) { typedef typename QtPrivate::remove_cv<typename QtPrivate::remove_pointer<T>::type>::type Item; return int(Item::Type) == int(QGraphicsItem::Type) || (item && int(Item::Type) == item->type()) ? static_cast<T>(item) : 0; }

实际应用

下面以获取 QGraphicsScene 中的所有 items 为例

QList<QGraphicsItem *> items = scene->items(); foreach (QGraphicsItem *item, items) { if (item->type() == QGraphicsRectItem::Type) { // 矩形 QGraphicsRectItem *rect = qgraphicsitem_cast<QGraphicsRectItem*>(item); // 访问 QGraphicsRectItem 的成员 } else if (item->type() == QGraphicsLineItem::Type) { // 直线 QGraphicsLineItem *line = qgraphicsitem_cast<QGraphicsLineItem*>(item); // 访问 QGraphicsLineItem 的成员 } else if (item->type() == QGraphicsProxyWidget::Type) { // 代理 Widget QGraphicsProxyWidget *proxyWidget = qgraphicsitem_cast<QGraphicsProxyWidget*>(item); QLabel *label = qobject_cast<QLabel *>(proxyWidget->widget()); // 访问 QLabel 的成员 } else if (item->type() == CustomItem::Type) { // 自定义 Item CustomItem *customItem = qgraphicsitem_cast<CustomItem*>(item); // 访问 CustomItem 的成员 } else { // 其他类型 item } }

首先根据 type() 判断 item 的类型。然后通过 qgraphicsitem_cast 进行转换。这样既可以访问标准 item也可以通过 QGraphicsProxyWidget 访问 QWidget以及访问自定义 item。