如何创建具有预定状态的自定义Quick QML项目

Question

我对Qt很陌生，所以我可能会问一个很明显的问题。

我想为要在C ++中创建的所有自定义QML GUI元素创建一个超类型。 该超类型应该将预定义状态添加到QML项。 与此类似：

    import StatedGuiElement 1.0
    import QtQuick 2.0

    Item {
        width: 300; height: 200

        StatedGuiElement {
            id: aStatedGuiElement
            anchors.centerIn: parent
            width: 100; height: 100
            //some visible Custom Gui Elements
    states:[
        State {
            name: "A_STATE"

        },
        State {
            name: "ANOTHER_STATE"
        }]
}

我知道如何根据本教程（ http://doc.qt.io/qt-5/qtqml-tutorials-extending-qml-example.html ）创建一个简单的自定义项。 我想状态可以通过使用从QQuickItem继承的C ++类中的枚举来定义。 但是，本教程没有显示如何创建更复杂的Qt Quick元素（如状态列表）。

class StatedGuiElement : public QQuickItem
{
    Q_OBJECT
    Q_PROPERTY(QString name READ name WRITE setName)
    //pass States via Q_PROPERTY?
public:
    //define Enum for fixed States here?
    //ENUM STATES {A_STATE, ANOTHER_STATE}
    StatedGuiElement( QQuickItem *parent = 0);

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


private:
    QString m_name;
    //Some List of States?


signals:

public slots:
};

因此，我想知道的问题如下：

• 甚至可以预定义QML状态类型并在多个元素中使用它们？
• 如何在C ++类（如StatedGuiElement添加复杂的QML类型（如状态列表）？

Answer 1

首先，将您的StatedGuiElement创建为QQuickItem子类。

然后，创建一个StatedGuiElement.qml ，导入包含C ++元素的包，在其中创建一个StatedGuiElement {}在其中添加您在QML中的状态，然后可以在您的项目中使用StatedGuiElement 。 它将是其中预定义了QML额外内容的一个。

这假设元素实际上具有您需要在C ++中实现的东西。 如果没有，那么完全没有C ++元素是没有意义的。 我不确定旧的C ++状态类是否可以与QML一起使用，并且使用C ++的QML状态将很不方便，因此您真的应该在QML中进行状态处理，而不管您可能拥有什么C ++东西。

Answer 2

如果将QML元素嵌套在定义了所有状态的超型QML元素内，则可以一次定义属性并在多个元素中使用它们。 子元素可以访问父参数。

另外，您也可以只为每个QML设置context属性，该属性应使用C ++中的数据：

QQuickView view;

QStringList data;

// fill the list with data via append()

view.rootContext()->setContextProperty("dataList", QVariant::fromValue(data));

// now the QML can freely use and access the list with the variable name "dataList"

view.setSource(QUrl::fromLocalFile("MyItem.qml"));
view.show();

在QML端，您还可以声明一个自定义属性，其中包含状态的名称。

Item {
    property variant state_list: ["element1", "element2", "element3"]
    // or if you defined a list in the C++ part as a context property
    // you can use this instead:
    // property variant state_list: dataList

    states: [
        State {
            name: state_list[0]
        },

        State {
            name: state_list[1]
        },

        // and so on
    ]
}

Answer 3

如果您需要一个包含元素列表的属性，即 states是State对象的列表，那么您可以使用QQmlListProperty类型在C ++中执行此QQmlListProperty 。

列表元素类型需要QObject派生类型。

例

class Entry : public QObject
{
    // the list entry element's API
};

class MyItem : public QQuickItem
{
    Q_OBJECT
    Q_PROPERTY(QQmlListProperty<Entry> entries READ entries)


public:
    QQmlListProperty<Entry> entries() const {
        return QQmlListProperty<Entry>(this, m_entries);
    }

private:
    QList<Entry*> m_entries;
};

用qmlRegisterType()都注册

在QML中

MyItem {
    entries: [
        Entry {
        },  
        Entry {
        }
    ]
}