QQuick3DObject Class

所有 3D 节点和资源的基类。更多...

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

所有成员的列表，包括继承的成员

属性

parent : QQuick3DObject*
state : QString

公共函数

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

公共槽位

void	setParentItem(QQuick3DObject *parentItem)

信号

void	parentChanged()
void	stateChanged()

详细说明

Object3D 是所有Qt Quick 3D 场景对象的基类。目前C++中可用的类型有：

这两种类型都是直接继承自 QQuick3DObject 的资源对象。

目前通常无需在任何地方直接使用 QQuick3DObject，因为它仅作为支持 3D 场景中空间项和资源的接口，同时为 3D 场景内容提供与QQuickItem 类似的功能。

属性文档

parent : QQuick3DObject*

该属性存储Object3D 在3D场景中的父级对象。

注意： Object3D的父级未必与其对象父级相同。这是必要的，因为对象父级可能不是Object3D 类型的项，例如场景中的根对象。

注意：目前， 若要在 C++ 中将 3D 对象设置为父对象时，确保场景管理器能正确处理这些 3D 对象，必须在调用 `QObject::setParent` 之前先调用 `QQuick3DObject::setParentItem`。不过，这一要求在未来的版本中可能会发生变化。

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

访问函数：

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

通知器信号：

void	parentChanged()

state : QString

该属性存储对象当前状态的名称。

如果该项处于默认状态（即未显式设置任何状态），则该属性存储一个空字符串。同样地，您可以通过将该属性设置为空字符串，将该项恢复为默认状态。

访问函数：

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

通知器信号：

void	stateChanged()

另请参阅《 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.