Extending QML - Adding Types Example¶
Exporting C++ Classes.
The Adding Types Example shows how to add a new object type,
Person, to QML. The
Person type can be used from QML like this:
<Code snippet "referenceexamples/adding/example.qml:0" not found>
Declare the Person Class¶
All QML types map to C++ types. Here we declare a basic C++ Person class with the two properties we want accessible on the QML type - name and shoeSize. Although in this example we use the same name for the C++ class as the QML type, the C++ class can be named differently, or appear in a namespace.
class Person(QObject): Q_OBJECT Q_PROPERTY(QString name READ name WRITE setName) Q_PROPERTY(int shoeSize READ shoeSize WRITE setShoeSize) QML_ELEMENT # public QObject.QObject = using() name = QString() def setName(): shoeSize = int() def setShoeSize(int): # private m_name = QString() m_shoeSize = 0
Define the Person Class¶
<Code snippet "referenceexamples/adding/person.cpp:0" not found>
The Person class implementation is quite basic. The property accessors simply return members of the object instance.
Running the Example¶
The main.cpp file in the example includes a simple shell application that loads and runs the QML snippet shown at the beginning of this page.
© 2022 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.