Qt Reference Documentation

QML QtObject Element

The QtObject element is the most basic element in QML. More...

QtObject instantiates the C++ class QObject

  • List of all members, including inherited members
  • Properties

    Detailed Description

    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:

     import QtQuick 1.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 1.0
    
     Item {
         width: 200; height: 200
    
         Rectangle {
             anchors.fill: parent
             color: "red"
             objectName: "myRect"
         }
     }
     // main.cpp
    
     QDeclarativeView view;
     view.setSource(QUrl::fromLocalFile("MyRect.qml"));
     view.show();
    
     QDeclarativeItem *item = view.rootObject()->findChild<QDeclarativeItem*>("myRect");
     if (item)
         item->setProperty("color", QColor(Qt::yellow));

    X

    Thank you for giving your feedback.

    Make sure it is related to this specific page. For more general bugs and requests, please use the Qt Bug Tracker.