QtObject QML Type

Un type QML de base. Plus d'informations...

Import Statement: import QtQml
In C++: QObject

Propriétés

Description détaillée

Le type QtObject est un élément non visuel qui ne contient que la propriété objectName.

Il peut être utile de créer un QtObject si vous avez besoin d'un type extrêmement léger pour contenir un ensemble de propriétés personnalisées :

import QtQuick

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

    Text { text: attributes.name }
}

Il peut également être utile pour l'intégration C++, puisqu'il s'agit simplement d'un QObject. Voir la documentation QObject pour plus de détails.

Documentation de la propriété

objectName : string

Cette propriété contient le site QObject::objectName pour cette instance d'objet spécifique.

Elle permet à une application C++ de localiser un élément dans un composant QML à l'aide de la méthode QObject::findChild(). Par exemple, l'application C++ suivante localise l'élément enfant Rectangle et modifie dynamiquement sa valeur color:

// 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));

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.