Sur cette page

QQuick3DObject Class

Classe de base de tous les nœuds et ressources 3D. En savoir plus...

Header: #include <QQuick3DObject>
In QML: Object3D
Inherits: QObject and QQmlParserStatus
Inherited By:

QQuick3DGeometry, QQuick3DInstancing, QQuick3DRenderExtension, and QQuick3DTextureData

Propriétés

Fonctions publiques

QQuick3DObject *parentItem() const
void setState(const QString &state)
QString state() const

Emplacements publics

void setParentItem(QQuick3DObject *parentItem)

Signaux

void parentChanged()
void stateChanged()

Description détaillée

Object3D est la classe de base de tous les objets de scène 3D d'Qt Quick. Actuellement, les types disponibles en C++ sont :

Ces deux types sont des objets de ressources qui héritent directement de QQuick3DObject.

Il ne devrait pas être nécessaire d’utiliser directement QQuick3DObject à l’heure actuelle, car il s’agit simplement d’une interface permettant de prendre en charge les éléments spatiaux et les ressources dans une scène 3D, ainsi que d’exposer des fonctionnalités similaires à celles d’ QQuickItem pour le contenu des scènes 3D.

Documentation des propriétés

parent : QQuick3DObject*

Cette propriété contient le parent de l'Object3D e dans une scène 3D.

Remarque : le parentd’un objet « Object3D » n’est pas nécessairement le même que son parent d’objet. Cela est nécessaire car le parent d’objet peut être un élément qui n’est pas de type « Object3D », par exemple l’objet racine d’une scène.

Remarque : Actuellement , pour que les éléments 3D soient correctement gérés par le gestionnaire de scène lors de la création de relations parent-enfant entre des objets 3D depuis C++, il est nécessaire d’appeler QQuick3DObject::setParentItem avant QObject::setParent. Cette exigence est toutefois susceptible d’évoluer dans une future version.

QQuick3DObject *newItem = new QQuick3DObject();
newItem->setParentItem(parentItem);
newItem->setParent(parentItem);

Fonctions d'accès :

QQuick3DObject *parentItem() const
void setParentItem(QQuick3DObject *parentItem)

Signal de notification :

void parentChanged()

state : QString

Cette propriété contient le nom de l'état actuel de l'objet.

Si l'élément se trouve dans son état par défaut, c'est-à-dire qu'aucun état explicite n'a été défini, cette propriété contient alors une chaîne vide. De même, vous pouvez rétablir l'état par défaut d'un élément en définissant cette propriété sur une chaîne vide.

Fonctions d'accès :

QString state() const
void setState(const QString &state)

Signal de notification :

void stateChanged()

Voir aussi États d'Qt Quick .

© 2026 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.