QtObject QML Type | Qt QML 5.9

Qt 5.9 | Qt QML | QML Types | QtObject QML Type

Qt 5.9.9 Reference Documentation

# QtObject QML Type

A basic QML type More...

Import Statement: | import QtQml 2.2
Instantiates: | QObject

- List of all members, including inherited members

## Properties

- objectName : string

## 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;
      view.setSource(QUrl::fromLocalFile("MyRect.qml"));
      view.show();

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