欧美bbbwbbbw肥妇,免费乱码人妻系列日韩,一级黄片

將?C++?類型屬性暴露給?QML

 更新時間:2021年12月14日 17:03:18   作者:友善啊,朋友  
這篇文章主要介紹了將?C++?類型屬性暴露給?QML,?QML?是一種基于?JavaScript?的聲明式語言。在?Qt5中,QML有了長足進步,并且同?C++?并列成為?Qt?的首選編程語言下面一起進入文章學習?QML的條件下也看看如何將將?C++?類型屬性暴露給?QML,需要的朋友可以參考一下

可以使用 C++ 代碼中定義的功能輕松擴展 QML。由于 QML 引擎與 Qt 元對象系統(tǒng)的緊密集成,QObject 派生類公開的任何功能都可以從 QML 代碼訪問。這使得 C++ 數(shù)據(jù)和函數(shù)可以直接從 QML 訪問,通常幾乎不需要修改。

QML 引擎能夠通過元對象系統(tǒng)反射 QObject 實例。這意味著任何 QML 代碼都可以訪問 QObject 派生類的實例的以下成員:

  • 屬性
  • 方法(前提是它們是 public slots 或用 Q_INVOKABLE 標記)
  • 信號

(此外,如果枚舉是用 Q_ENUMS 聲明的,則也可以訪問)

一、數(shù)據(jù)類型處理和所有權

任何從 C++ 傳輸?shù)?QML 的數(shù)據(jù),無論是作為屬性值、方法參數(shù)或返回值,還是信號參數(shù)值,都必須是 QML 引擎支持的類型。

默認情況下,引擎支持許多 Qt C++ 類型,并且可以在從 QML 使用時自動適當?shù)剞D換它們。

1.1、暴露屬性

可以使用 Q_PROPERTY() 宏為任何 QObject 派生類指定屬性。

例如,下面是一個具有作者屬性的 Message 類。 正如 Q_PROPERTY 宏調用所指定的,這個屬性可以通過 author() 方法讀取,通過 setAuthor() 方法寫入:

注意:不要使用 typedef 或 using 指定 Q_PROPERTY 類型,因為它們會混淆 moc。 這可能會使某些類型比較失敗。

錯誤用法:

using FooEnum = Foo::Enum;
 
class Bar : public QObject 
{
    Q_OBJECT
    Q_PROPERTY(FooEnum enum READ enum WRITE setEnum NOTIFY enumChanged)
};


正確用法:

class Bar : public QObject 
{
    Q_OBJECT
    Q_PROPERTY(Foo::Enum enum READ enum WRITE setEnum NOTIFY enumChanged)
};


暴露屬性實例:

class Message : public QObject
{
    Q_OBJECT
    Q_PROPERTY(QString author READ author WRITE setAuthor NOTIFY authorChanged)
public:
    void setAuthor(const QString &a) 
    {
        if (a != m_author) 
        {
            m_author = a;
            emit authorChanged();
        }
    }
    QString author() const 
    {
        return m_author;
    }
signals:
    void authorChanged();
private:
    QString m_author;
};


如果在從 C++ 加載名為 MyItem.qml 的文件時將此類的實例設置為上下文屬性:

int main(int argc, char *argv[]) 
{
    QGuiApplication app(argc, argv);
 
    QQuickView view;
    Message msg;
    view.engine()->rootContext()->setContextProperty("msg", &msg);
    view.setSource(QUrl::fromLocalFile("MyItem.qml"));
    view.show();
 
    return app.exec();
}
然

可以從 MyItem.qml 中讀取 author 屬性:

// MyItem.qml
import QtQuick 2.0
 
Text 
{
    width: 100; height: 100
    text: msg.author    // 調用 Message::author() 來獲取這個值
 
    Component.onCompleted: 
    {
        msg.author = "Jonah"  // 調用 Message::setAuthor()    
    }
}


為了實現(xiàn)C++與 QML 的最大互操作性,任何可寫的屬性都應該有一個關聯(lián)的 NOTIFY 信號,該信號在屬性值更改時發(fā)出。這允許屬性與屬性綁定一起使用,這是 QML 的一個基本特性,它通過在任何依賴項的值發(fā)生變化時自動更新屬性來強制執(zhí)行屬性之間的關系。即發(fā)出信號會通知 QML 引擎更新任何涉及屬性的綁定。

上面示例中如果 author 屬性可寫但沒有關聯(lián)的 NOTIFY 信號,則文本值將使用 Message::author() 返回的初始值進行初始化,但不會隨此屬性的任何后續(xù)更改而更新。此外,任何從 QML 綁定到屬性的嘗試都會從引擎產(chǎn)生運行時警告。

建議將 NOTIFY 信號命名為 <property>Changed,其中 <property> 是屬性的名稱。QML 引擎生成的關聯(lián)屬性更改信號處理程序將始終采用 on<Property>Changed 形式,無論相關 C++ 信號的名稱如何,因此建議信號名稱遵循此約定以避免任何混淆。

1.2、使用通知信號的注意事項

開發(fā)人員應確保僅在屬性值實際更改時才發(fā)出屬性更改信號。此外,如果一個屬性或一組屬性不經(jīng)常使用,則允許對多個屬性使用相同的 NOTIFY 信號。這應該小心完成以確保性能不會受到影響。

NOTIFY 信號的存在確實會產(chǎn)生很小的開銷。在某些情況下,屬性的值是在對象構造時設置的,隨后不會更改。在這些情況下,可以將 CONSTANT 屬性而不是 NOTIFY 信號添加到屬性聲明中。

CONSTANT 屬性應僅用于其值僅在類構造函數(shù)中設置和最終確定的屬性。

1.3、具有對象類型的屬性

對象類型屬性可從 QML 訪問,前提是對象類型已正確注冊到 QML 類型系統(tǒng)。

例如:Message 類型可能具有 MessageBody* 類型的 body 屬性

class Message : public QObject
{
    Q_OBJECT
    Q_PROPERTY(MessageBody* body READ body WRITE setBody NOTIFY bodyChanged)
public:
    MessageBody* body() const;
    void setBody(MessageBody* body);
};
 
class MessageBody : public QObject
{
    Q_OBJECT
    Q_PROPERTY(QString text READ text WRITE text NOTIFY textChanged)
// ...
}


假設 Message 類型已在 QML 類型系統(tǒng)中注冊,

允許將其用作 QML 代碼中的對象類型:

Message
{
    // ...
}


如果 MessageBody 類型也注冊到類型系統(tǒng),則可以將 MessageBody 分配給 Message body 屬性:

Message 
{
    body: MessageBody 
    {
        text: "Hello, world!"
    }
}


1.4、具有對象列表類型的屬性

包含 QObject 派生類型列表的屬性也可以暴露給 QML。然而,應該使用 QQmlListProperty 而不是 QList<T> 作為屬性類型。 這是因為 QList 不是 QObject 派生的類型,因此無法通過 Qt 元對象系統(tǒng)提供必要的 QML 屬性特征,例如修改列表時的信號通知。

例如,下面的 MessageBoard 類有一個 QQmlListProperty 類型的消息屬性,用于存儲 Message 實例列表:

class MessageBoard : public QObject
{
    Q_OBJECT
    Q_PROPERTY(QQmlListProperty<Message> messages READ messages)
public:
    QQmlListProperty<Message> messages()
    {
        return QQmlListProperty<Message>(this, 0, &MessageBoard::append_message);
    }
 
private:
    static void append_message(QQmlListProperty<Message> *list, Message *msg)
    {
        MessageBoard *msgBoard = qobject_cast<MessageBoard *>(list->object);
        if (msg)
            msgBoard->m_messages.append(msg);
    }
    QList<Message *> m_messages;
};
QQmlListProperty 的模板類類型(在本例中為 Message)必須在 QML 類型系統(tǒng)中注冊。

1.5、分組屬性

任何只讀的對象類型屬性都可以作為分組屬性從 QML 代碼訪問。這可用于公開一組相關屬性,這些屬性描述了類型的一組屬性。

例如,假設 Message::author 屬性的類型是 MessageAuthor 而不是簡單的字符串,具有 name email 的子屬性:

class MessageAuthor : public QObject
{
    Q_PROPERTY(QString name READ name WRITE setName)
    Q_PROPERTY(QString email READ email WRITE setEmail)
public:
    ...
};
 
class Message : public QObject
{
    Q_OBJECT
    Q_PROPERTY(MessageAuthor* author READ author)
public:
    Message(QObject *parent)
        : QObject(parent), m_author(new MessageAuthor(this))
    {
    }
    MessageAuthor *author() const 
    {
        return m_author;
    }
private:
    MessageAuthor *m_author;
};


可以使用 QML 中的分組屬性語法編寫 author 屬性:

Message 
{
    author.name: "Alexandra"
    author.email: "alexandra@mail.com"
}


分組屬性是只讀的,并且在構造時由父對象初始化為有效值。

分組屬性的子屬性可以從 QML 修改,但分組屬性對象本身永遠不會改變,

二、暴露方法

QObject 派生類型的任何方法都可以從 QML 代碼訪問,只要它滿足其中一項:

  • Q_INVOKABLE() 宏標記的公共方法
  • 作為 public slot 的方法

例如,下面的 MessageBoard 類有一個使用 Q_INVOKABLE 宏標記的 postMessage() 方法,以及一個公共槽的 refresh() 方法:

class MessageBoard : public QObject
{
    Q_OBJECT
public:
    Q_INVOKABLE bool postMessage(const QString &msg) 
    {
        qDebug() << "Called the C++ method with" << msg;
        return true;
    }
 
public slots:
    void refresh() 
    {
        qDebug() << "Called the C++ slot";
    }
};


如果將 MessageBoard 的實例設置為文件 MyItem.qml 的上下文數(shù)據(jù),則 MyItem.qml 可以調用兩個方法,如下例所示:

int main(int argc, char *argv[]) 
{
    QGuiApplication app(argc, argv);
 
    MessageBoard msgBoard;
    QQuickView view;
    view.engine()->rootContext()->setContextProperty("msgBoard", &msgBoard);
    view.setSource(QUrl::fromLocalFile("MyItem.qml"));
    view.show();
 
    return app.exec();
}
// MyItem.qml
import QtQuick 2.0
 
Item 
{
    width: 100; height: 100
 
    MouseArea 
    {
        anchors.fill: parent
        onClicked: 
        {
            var result = msgBoard.postMessage("Hello from QML")
            console.log("Result of postMessage():", result)
            msgBoard.refresh();
        }
    }
}


如果 C++ 方法具有 QObject* 類型的參數(shù),則可以使用對象 id 或引用該對象的 JavaScript 變量值從 QML 傳遞參數(shù)值。

QML 支持調用重載的 C++ 函數(shù)。 如果存在多個同名但參數(shù)不同的 C++ 函數(shù),則會根據(jù)提供的參數(shù)數(shù)量和類型調用正確的函數(shù)。

當從 QML 中的 JavaScript 表達式訪問時,從 C++ 方法返回的值將轉換為 JavaScript 值。

三、暴露信號

QObject 派生類型的任何公共信號都可以從 QML 代碼訪問。

QML 引擎自動為從 QML 使用的 QObject 派生類型的任何信號創(chuàng)建信號處理程序。信號處理程序始終命名為 on<Signal>,其中 <Signal> 是信號的名稱,首字母大寫。 信號傳遞的所有參數(shù)都可以通過參數(shù)名稱在信號處理程序中使用。

例如,假設 MessageBoard 類有一個帶有單個參數(shù)主題的 newMessagePosted() 信號:

class MessageBoard : public QObject
{
    Q_OBJECT
public:
   // ...
signals:
   void newMessagePosted(const QString &subject);
};


?如果 MessageBoard 類型已注冊到 QML 類型系統(tǒng),則在 QML 中聲明的 MessageBoard 對象可以使用名為 onNewMessagePosted 的信號處理程序接收 newMessagePosted() 信號,并檢查主題參數(shù)值:

MessageBoard 
{
    onNewMessagePosted: (subject)=> console.log("New message received:", subject)
}


與屬性值和方法參數(shù)一樣,信號參數(shù)必須具有 QML 引擎支持的類型。(使用未注冊的類型不會產(chǎn)生錯誤,但處理程序將無法訪問參數(shù)值。)

請注意:QML引擎無法區(qū)分名稱相同但參數(shù)不同的信號,類可能有多個同名的信號,但只有最后一個信號可以作為 QML 信號訪問。

到此這篇關于將 C++ 類型屬性暴露給 QML的文章就介紹到這了,更多相關? C++ 類型屬性暴露給 QML內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家!

相關文章

  • C語言中access/_access函數(shù)的使用實例詳解

    C語言中access/_access函數(shù)的使用實例詳解

    本文通過實例代碼給大家介紹了C語言中access/_access函數(shù)的使用,代碼簡單易懂,非常不錯,具有一定的參考借鑒價值,需要的朋友可以參考下
    2019-09-09
  • c++深入淺出講解堆排序和堆

    c++深入淺出講解堆排序和堆

    在c++里有很多排序方法,比如相對簡單的冒泡排序、選擇排序、插入排序,還有 STL里的sort函數(shù)  手寫快排  歸并排序等,還有就是堆排序,這次主要說堆排序和堆
    2022-03-03
  • C語言全排列回溯算法介紹

    C語言全排列回溯算法介紹

    大家好,本篇文章主要講的是C語言全排列回溯算法介紹,感興趣的同學趕快來看一看吧,對你有幫助的話記得收藏一下
    2022-01-01
  • C語言必背的一些經(jīng)典程序代碼實例

    C語言必背的一些經(jīng)典程序代碼實例

    C語言是一種高級編程語言,具有很多優(yōu)點,下面這篇文章主要給大家介紹了關于C語言必背的一些經(jīng)典程序代碼,文中通過詳細的實例代碼介紹的非常詳細,需要的朋友可以參考下
    2023-05-05
  • qt實現(xiàn)倒計時示例

    qt實現(xiàn)倒計時示例

    這篇文章主要介紹了qt實現(xiàn)倒計時示例,需要的朋友可以參考下
    2014-05-05
  • C/C++運用WMI接口實現(xiàn)查詢系統(tǒng)信息

    C/C++運用WMI接口實現(xiàn)查詢系統(tǒng)信息

    Windows?Management?Instrumentation(WMI)是一種用于管理和監(jiān)視Windows操作系統(tǒng)的框架,本文主要介紹了如何運用WMI接口實現(xiàn)查詢系統(tǒng)信息,感興趣的可以了解下
    2023-11-11
  • C++ Boost Bind庫示例分析使用

    C++ Boost Bind庫示例分析使用

    Boost是為C++語言標準庫提供擴展的一些C++程序庫的總稱。Boost庫是一個可移植、提供源代碼的C++庫,作為標準庫的后備,是C++標準化進程的開發(fā)引擎之一,是為C++語言標準庫提供擴展的一些C++程序庫的總稱
    2022-11-11
  • C++大數(shù)模板(推薦)

    C++大數(shù)模板(推薦)

    本篇文章是對C++大數(shù)模板的程序代碼進行了詳細的分析介紹,需要的朋友參考下
    2013-05-05
  • C++提取文件中信息的方法

    C++提取文件中信息的方法

    這篇文章主要為大家詳細介紹了C++提取文件中信息的方法,具有一定的參考價值,感興趣的小伙伴們可以參考一下
    2017-07-07
  • C++構造函數(shù)一些常見的坑

    C++構造函數(shù)一些常見的坑

    這篇文章主要給大家分享的是C++構造函數(shù)一些常見的坑,文章圍繞C++構造函數(shù)的相關資料展開關于C++構造函數(shù)坑的內容,具有一定的參考價值,需要的小伙伴可以參考一下
    2022-01-01

最新評論