简述

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

类型检测

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。