简述

由于 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 
     
       inline T qgraphicsitem_cast(const QGraphicsItem *item){    typedef typename QtPrivate::remove_cv
      
       ::type>::type Item;    return int(Item::Type) == int(QGraphicsItem::Type)        || (item && int(Item::Type) == item->type()) ? static_cast
       
        (item) : 0;}

实际应用

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

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

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