Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries over the next few weeks. Thanks for all your past and future contributions.

Revision as of 19:58, 31 October 2013 by kiran10182 (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Using objectName to find QML elements from Qt

From Wiki
Jump to: navigation, search
Article Metadata
Tested with
Devices(s): E7, N8, N900
Platform(s): Symbian
Keywords: QML, objectName
Created: kratsan (27 Dec 2010)
Last edited: kiran10182 (31 Oct 2013)



This code shows how to find QML element from Qt code by using the objectName property. This is done by first retrieving the root object of the QML document and then recursively iterating through the object hierarchy until the desired object is found. By this way the signals, properties and functions of a QML element can be accessed from Qt code more easily and they don't need to exist in the root element of the Qt Quick application. This leads to better modularity and reusability of the QML code.

This technique was used in the Nokia Developer example Dj Turntable to simplify the QML code.


  • Qt 4.7 or higher is installed on your platform.


QT       += core gui declarative
SOURCES += main.cpp
HEADERS += myclass.h
RESOURCES += resources.qrc
unix:!symbian {
maemo5 {
target.path = /opt/usr/bin
} else {
target.path = /usr/local/bin
INSTALLS += target


<qresource prefix="/">


MyClass is used to interact with the QML element given in constructor. The handleClick slot receives the button press signal from QML code and sets the QML elements property label to the string "Qt was here".

#ifndef MYCLASS_H
#define MYCLASS_H
#include <QObject>
#include <QVariant>
class MyClass : public QObject
MyClass(QObject *QMLObject) : m_QMLObject(QMLObject) {}
public slots:
void handleClick() {
m_QMLObject->setProperty("label", "Qt was here");
QObject *m_QMLObject;
#endif // MYCLASS_H


In the main function the instance of button element is searched from the QML namespace by using the rootObject of the QDeclarativeView and the findChild member function. After finding out the desired QML element, we connect the signal clicked to the Qt slot handleClick.

#include <QApplication>
#include <QDeclarativeView>
#include <QGraphicsObject>
#include <QMessageBox>
#include "myclass.h"
int main(int argc, char *argv[])
QApplication app(argc, argv);
QDeclarativeView view;
QObject *buttonQML = view.rootObject()->findChild<QObject*>("button"); //button is the object name, which needs to be define in qml for the component.e.g. objectName: "button"
if(buttonQML == NULL) {
QMessageBox::warning(NULL, "Warning", "Failed to resolve button QML element");
return 1;
MyClass myClass(buttonQML);
QObject::connect(buttonQML, SIGNAL(clicked()), &myClass, SLOT(handleClick()));
#if defined(Q_OS_SYMBIAN) || defined(Q_WS_MAEMO_5) || defined(Q_WS_SIMULATOR)
view.setGeometry(100, 100, 640, 360);;
return app.exec();


In the QML code we must define instance of the QML element with distinctive objectName property in order to find it from Qt code.

import Qt 4.7
Rectangle {
width: 640; height: 480
color: "black"
Rectangle {
id: button
objectName: "button"
signal clicked()
property alias label: buttonLabel.text
anchors.centerIn: parent
width: 200; height: 60; color: "gray"; radius: 10
Behavior on scale { NumberAnimation { duration: 50 } }
Text {
id: buttonLabel
anchors.centerIn: parent
font { bold: true; pixelSize: 20 }
text: "Press me"
color: "white"
MouseArea {
anchors.fill: parent
onPressed: button.scale = 0.9
onReleased: button.scale = 1.0
onClicked: button.clicked()


This code snippet demonstrated a way to retrieve specific QML elements in Qt code to interact with them directly.

This page was last modified on 31 October 2013, at 19:58.
248 page views in the last 30 days.

Was this page helpful?

Your feedback about this content is important. Let us know what you think.


Thank you!

We appreciate your feedback.