このページでは

QQuick3DObject Class

すべての3Dノードおよびリソースの基底クラス。詳細...

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

QQuick3DGeometry, QQuick3DInstancing, QQuick3DRenderExtension, and QQuick3DTextureData

プロパティ

パブリック関数

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 と同様の機能を提供するものであるため、現時点ではどこにおいてもQQuick3DObjectを直接使用する必要はありません。

プロパティのドキュメント

parent : QQuick3DObject*

このプロパティは、3DシーンにおけるObject3D の親オブジェクトを保持します。

注: 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)

Notifierシグナル:

void parentChanged()

state : QString

このプロパティには、オブジェクトの現在の状態の名前が格納されます。

アイテムがデフォルトの状態、つまり明示的な状態が設定されていない場合、このプロパティには空の文字列が格納されます。同様に、このプロパティを空の文字列に設定することで、アイテムをデフォルトの状態に戻すことができます。

アクセス関数:

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

Notifierシグナル:

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.