向qml注册类型

当我们打算向qml中注册自定义的C++类型时,有几个问题需要考虑:
1. 怎么将C++类型注册到qml框架中,即怎么在qml文件中访问该类型;
2. qml文件中怎么访问自定义C++类型的属性;
3. qml文件中怎么访问自定义C++类型的接口函数;
4. qml文件中怎么处理该自定义C++类型的信号。

向qml框架注册自定C++类型:

注册接口qmlRegisterType<CClassName>("PackageName", basVersion, subVersion, "QmlTypeName")
例如:

qmlRegisterType<PieChart>("Charts", 1, 0, "PieChart");

在qml中引用该类型:

import Charts 1.0

Item {
    width: 300; height: 200

    PieChart {
        id: aPieChart
        anchors.centerIn: parent
        width: 100; height: 100
        ...
        ...
        ...
    }
}

qml访问自定义C++类型的属性:

首先我们思考一个问题:是不是我们只需要将属性定义为public类型,就可以直接在qml中访问该类型的属性了呢?经过测试,证明这样不可行!必须在C++代码中注册属性,并实现其getter和setter接口:
Q_PROPERTY(QString propertyName READ getter WRITE setter)
代码如下:

class PieChart : public QObject
{
    Q_OBJECT
    //Q_PROPERTY宏申明的属性,可以在qml中使用,还可以用NOTIFY申明信号
    Q_PROPERTY(QString name READ name WRITE setName)
    Q_PROPERTY(QColor color READ color WRITE setColor)

public:
    PieChart(QQuickItem *parent = 0);

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

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

private:
    QString m_name;
    QColor m_color;
};

这样就可以在qml中访问其name和color属性了,其值的读取和设置分别由
QString name() const;
void setName(const QString &name);

QColor color() const;
void setColor(const QColor &color);提供;
但是有一点需要注意,此时还只能做简单的属性访问和设置,但是不能再qml中对该属性做动态绑定,因为qml框架无法感知属性的变化,自然无法处理该属性的动态绑定问题,那如何能让qml框架感知属性变化,从而实现动态绑定的效果呢?很显然这要用到Qt的信号槽机制,同样还是需要用到Q_PROPERTY来处理:
Q_PROPERTY(QString propertyName READ getter WRITE setter NOTITY propertyChanged)
代码如下:

class PieChart :  public QObject
{
    Q_OBJECT
    Q_PROPERTY(QString name READ name WRITE setName)
//! NOTIFY申明信号,通知qml监听属性变化,可以让qml框架感知属性变化,自动实现数据绑定效果
//! 否则需要自己处理信号,处理每一处的绑定数据的更新!!!!
    Q_PROPERTY(QColor color READ color WRITE setColor NOTIFY colorChanged)
public:
    PieChart(QQuickItem *parent = 0);

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

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

    void paint(QPainter *painter);

signals:
    void colorChanged();

private:
    QString m_name;
    QColor m_color;
};

//在属性发生变化是,发送信号
void PieChart::setColor(const QColor &color)
{
    if (color != m_color) {
        m_color = color;
        update();   // repaint with the new color
        emit colorChanged();
    }
}

qml访问自定义C++类型的函数:

同样的不能说只是定义成public的函数,就能被qml访问到,一样的需要申明和注册Q_INVOKABLE:
代码如下:

Q_INVOKABLE void clearChart();

在qml中就可以如下访问该接口了:

Item {
    width: 300; height: 200

    PieChart {
        id: aPieChart
        anchors.centerIn: parent
        width: 100; height: 100
        color: "red"
    }

    MouseArea {
        anchors.fill: parent
        onClicked: {
           //调用自定义接口
            aPieChart.clearChart();
            }
        }
    }
}

备注:public slot也可以被qml直接调用!

qml访问自定义C++类型的信号

信号可以直接访问:

//c++文件
signals:
    void chartCleared();

//qml文件:
PieChart {
        id: aPieChart
        anchors.centerIn: parent
        width: 100; height: 100
        color: "red"

        //可以直接获取到chartCleared,不需要特殊的处理
        onChartCleared: console.log("The chart has been cleared")
    }
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,734评论 6 505
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,931评论 3 394
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,133评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,532评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,585评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,462评论 1 302
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,262评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,153评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,587评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,792评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,919评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,635评论 5 345
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,237评论 3 329
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,855评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,983评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,048评论 3 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,864评论 2 354

推荐阅读更多精彩内容