QQuick3DObject Class

Basisklasse aller 3D-Knoten und -Ressourcen. Mehr...

Header:	`#include <QQuick3DObject>`
In QML:	Object3D
Inherits:	QObject and QQmlParserStatus
Inherited By:	QQuick3DGeometry, QQuick3DInstancing, QQuick3DRenderExtension, and QQuick3DTextureData

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

parent : QQuick3DObject*
state : QString

Öffentliche Funktionen

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

Öffentliche Slots

void	setParentItem(QQuick3DObject *parentItem)

Signale

void	parentChanged()
void	stateChanged()

Ausführliche Beschreibung

Object3D ist die Basisklasse für alle Szenenobjekte von „ Qt Quick 3D “. Derzeit sind in C++ folgende Typen verfügbar:

Beide Typen sind Ressourcenobjekte, die direkt von `QQuick3DObject` erben.

Derzeit sollte es nicht notwendig sein, QQuick3DObject irgendwo direkt zu verwenden, da es lediglich eine Schnittstelle zur Unterstützung räumlicher Elemente und Ressourcen in einer 3D-Szene darstellt und ähnliche Funktionen wie „ QQuickItem “ für 3D-Szeneninhalte bereitstellt.

Dokumentation zu den Eigenschaften

parent : QQuick3DObject*

Diese Eigenschaft enthält das übergeordnete Element des „ Object3D “ in einer 3D-Szene.

Hinweis: Das übergeordnete Objekteines „ Object3D “ muss nicht unbedingt mit seinem Objekt-Elternteil übereinstimmen. Dies ist erforderlich, da es sich bei dem Objekt-Elternteil um ein Element handeln kann, das nicht vom Typ „ Object3D “ ist, beispielsweise das Stammobjekt in einer Szene.

Hinweis: Damit 3D-Elemente beim Festlegen von übergeordneten 3D-Objekten aus C++ vom Szenenmanager korrekt verarbeitet werden, mussderzeit vor dem Aufruf von ` QObject::setParent` die Funktion `QQuick3DObject::setParentItem` aufgerufen werden. Diese Anforderung wird sich jedoch in einer zukünftigen Version wahrscheinlich ändern.

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

Zugriffsfunktionen:

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

Notifier-Signal:

void	parentChanged()

state : QString

Diese Eigenschaft enthält den Namen des aktuellen Zustands des Objekts.

Befindet sich das Element in seinem Standardzustand, d. h., es wurde kein expliziter Zustand festgelegt, enthält diese Eigenschaft eine leere Zeichenkette. Ebenso können Sie ein Element in seinen Standardzustand zurücksetzen, indem Sie diese Eigenschaft auf eine leere Zeichenkette setzen.

Zugriffsfunktionen:

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

Notifier-Signal:

void	stateChanged()

Siehe auch „Qt Quick -Zustände“.

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