Extending QML - Extension Objects Example#

Extension Objects.

This example builds on:

Shows how to use QML_EXTENDED to provide an extension object to a QLineEdit without modifying or subclassing it.

Firstly, the LineEditExtension class is registered with the QML system as an extension of QLineEdit . We declare a foreign type to do this as we cannot modify Qt’s internal QLineEdit class.

<Code snippet "referenceexamples/extended/lineedit.h:0" not found>

Note the usage of QML_NAMED_ELEMENT() instead of QML_ELEMENT . QML_ELEMENT uses the name of the containing type by default, “LineEditExtension” in this case. As the class being an extension class is an implementation detail, we choose the more natural name “LineEdit” instead

The QML engine then instantiates a QLineEdit :

<Code snippet "referenceexamples/extended/main.cpp:1" not found>

In QML, a property is set on the line edit that only exists in the LineEditExtension class:

<Code snippet "referenceexamples/extended/example.qml:0" not found>

The extension type performs calls on the QLineEdit that otherwise will not be accessible to the QML engine.

Example project @ code.qt.io