Qt5官方demo解析集19——Chapter 五: Using List Property Types

Qt5官方demo解析集19——Chapter 5: Using List Property Types

本系列所有文章可以在这里查看http://blog.csdn.net/cloud_castle/article/category/2123873

接上文Qt5官方demo解析集18——Chapter 4: Using Custom Property Types

上个例子向我们展示了如何为QML调用的C++类型添加自定义类型的属性，在这个例子中我们更进一步，将这个类型更换为一个PieSlice的列表，以此得到更丰富的处理能力。

项目文件与上个例子是一样的。

还是先看看piechart.h:

#ifndef PIECHART_H
#define PIECHART_H

#include <QtQuick/QQuickItem>

class PieSlice;                    // 由于这里只使用了PieSlice的指针，我们可以使用前向声明

//![0]
class PieChart : public QQuickItem
{
    Q_OBJECT
    Q_PROPERTY(QQmlListProperty<PieSlice> slices READ slices)  // 我们使用QQmlListProperty<PieSlice>来定义slices属性的类型
//![0]                                                         // 该属性是一个PieSlice的列表，而<span style="font-family: Arial;">QQmlListProperty则为我们提供了在QML中扩充该列表的能力</span>
    Q_PROPERTY(QString name READ name WRITE setName)           // 由于QQmlListProperty的机制，即使我们没有定义该属性的WRITE功能，它也是可改变的

//![1]
public:
//![1]
    PieChart(QQuickItem *parent = 0);

    QString name() const;
    void setName(const QString &name);

//![2]
    QQmlListProperty<PieSlice> slices();     // 我们在属性中仅仅定义了可读性，因此这里并没有声明setSlices()函数

private:
    static void append_slice(QQmlListProperty<PieSlice> *list, PieSlice *slice);   // <span style="font-family: Arial;">定义一个（append_属性名）函数用来向列表中添加属性成员</span>

    QString m_name;
    QList<PieSlice *> m_slices;                    // 定义一个对应的数据成员
};
//![2]

#endif

piechart.cpp:

#include "piechart.h"
#include "pieslice.h"

PieChart::PieChart(QQuickItem *parent)
    : QQuickItem(parent)
{
}

QString PieChart::name() const
{
    return m_name;
}

void PieChart::setName(const QString &name)
{
    m_name = name;
}

//![0]
QQmlListProperty<PieSlice> PieChart::slices()               // 用来返回列表中的属性
{
    return QQmlListProperty<PieSlice>(this, 0, &PieChart::append_slice, 0, 0, 0);
}

void PieChart::append_slice(QQmlListProperty<PieSlice> *list, PieSlice *slice)  // <span style="font-family: Arial;">每当我们向slices中添加一个PieSlice都会调用这个静态的内部函数</span>
{
    PieChart *chart = qobject_cast<PieChart *>(list->object);  // 取得列表的父对象
    if (chart) {                                               // 并设置为新属性成员的父对象
        slice->setParentItem(chart);
        chart->m_slices.append(slice);
    }
}
//![0]

pieslice.h:

#ifndef PIESLICE_H
#define PIESLICE_H

#include <QtQuick/QQuickPaintedItem>
#include <QColor>

//![0]
class PieSlice : public QQuickPaintedItem
{
    Q_OBJECT
    Q_PROPERTY(QColor color READ color WRITE setColor)
    Q_PROPERTY(int fromAngle READ fromAngle WRITE setFromAngle)  // 添加了扇形的起始角与角度范围属性
    Q_PROPERTY(int angleSpan READ angleSpan WRITE setAngleSpan)  // 用来绘制饼状图的多个扇形的不同颜色
//![0]

public:
    PieSlice(QQuickItem *parent = 0);

    QColor color() const;
    void setColor(const QColor &color);

    int fromAngle() const;
    void setFromAngle(int angle);

    int angleSpan() const;
    void setAngleSpan(int span);

    void paint(QPainter *painter);

private:
    QColor m_color;
    int m_fromAngle;                 // 注意与定义的属性类型对应
    int m_angleSpan;
};

#endif

pieslice.cpp:

#include "pieslice.h"

#include <QPainter>

PieSlice::PieSlice(QQuickItem *parent)
    : QQuickPaintedItem(parent)
{
}

QColor PieSlice::color() const
{
    return m_color;
}

void PieSlice::setColor(const QColor &color)
{
    m_color = color;
}

int PieSlice::fromAngle() const
{
    return m_fromAngle;
}

void PieSlice::setFromAngle(int angle)
{
    m_fromAngle = angle;
}

int PieSlice::angleSpan() const
{
    return m_angleSpan;
}

void PieSlice::setAngleSpan(int angle)
{
    m_angleSpan = angle;
}

void PieSlice::paint(QPainter *painter)             
{
    QPen pen(m_color, 2);
    painter->setPen(pen);
    painter->setRenderHints(QPainter::Antialiasing, true);
    painter->drawPie(boundingRect().adjusted(1, 1, -1, -1), m_fromAngle * 16, m_angleSpan * 16);
}

app.qml:

import Charts 1.0
import QtQuick 2.0

Item {
    width: 300; height: 200

    PieChart {
        anchors.centerIn: parent
        width: 100; height: 100

        slices: [                           // 使用中括号括起列表中的成员
            PieSlice { 
                anchors.fill: parent
                color: "red"
                fromAngle: 0; angleSpan: 110 
            },
            PieSlice { 
                anchors.fill: parent
                color: "black"
                fromAngle: 110; angleSpan: 50 
            },
            PieSlice { 
                anchors.fill: parent
                color: "blue"
                fromAngle: 160; angleSpan: 100
            }
        ]
    }
}

运行效果如下：