Contents

QML:QtObject Element Reference

The QtObject element is the most basic element in QML.

[QML:QtObject instantiates the C++ class QObject]

This element was introduced in Qt 4.7.

Detailed Description

The QtObject element is the most basic element in QML.

The QtObject element 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 element to enclose a set of custom properties:

  1. import QtQuick 1.0
  2.  
  3. Item  {
  4.     QtObject  {
  5.         id: attributes
  6.         property string name
  7.         property int size
  8.         property variant attributes
  9.     }
  10.  
  11.     Text  { text: attributes.name }
  12. }

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

See also QMetaObject, QPointer, QObjectCleanupHandler, Q_DISABLE_COPY(), and Object Trees & Ownership.

Properties

Property Documentation

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:

  1. // MyRect.qml
  2.  
  3. import QtQuick 1.0
  4.  
  5. Item  {
  6.     width: 200; height: 200
  7.  
  8.     Rectangle  {
  9.         anchors.fill: parent
  10.         color: "red"
  11.         objectName: "myRect"
  12.     }
  13. }
  1. // main.cpp
  2.  
  3. QDeclarativeView view;
  4. view.setSource(QUrl::fromLocalFile("MyRect.qml"));
  5. view.show();
  6.  
  7. QDeclarativeItem *item = view.rootObject()->findChild<QDeclarativeItem*>("myRect");
  8. if (item)
  9.     item->setProperty("color", QColor(Qt::yellow));
You may use the documentation under the terms of the GNU Free Documentation License version 1.3, as published by the Free Software Foundation. Alternatively, you may use the documentation in accordance with the terms contained in a written agreement between you and Digia.

Hide Notes

Notes provided by the Qt Community

No notes

Creative Commons Attribution-ShareAlike 2.5 Generic

Community Notes are available under

Attribution-Share Alike 2.5 Generic

© 2013 Qt Project Hosting. Qt® and the Qt logo is a registered trade mark of Digia plc and/or its subsidiaries and is used pursuant to a license from Digia plc and/or its subsidiaries.
All other trademarks are property of their respective owners. Privacy Policy
This site is hosted by Gitorious AS. Your use of this web site is governed by these terms of service.

Qt Project Hosting, P.O. Box 4332 Nydalen, 0402 Oslo, Norway. Org. Nr. 997 447 913