QtObject QML Type

A basic QML type. More...

Import Statement: import QtQml 2.12
Instantiates: QObject


Detailed Description

The QtObject type is a non-visual element which contains only the objectName property.

It can be useful to create a QtObject if you need an extremely lightweight type to enclose a set of custom properties:

  import QtQuick 2.0

  Item {
      QtObject {
          id: attributes
          property string name
          property int size
          property variant attributes

      Text { text: attributes.name }

It can also be useful for C++ integration, as it is just a plain QObject. See the QObject documentation for further details.

Property Documentation

objectName : string

This property holds the QObject::objectName for this specific object instance.

This allows a C++ application to locate an item within a QML component using the QObject::findChild() method. For example, the following C++ application locates the child Rectangle item and dynamically changes its color value:

  // MyRect.qml

  import QtQuick 2.0

  Item {
      width: 200; height: 200

      Rectangle {
          anchors.fill: parent
          color: "red"
          objectName: "myRect"

  // main.cpp

  QQuickView view;

  QQuickItem *item = view.rootObject()->findChild<QQuickItem*>("myRect");
  if (item)
      item->setProperty("color", QColor(Qt::yellow));