Back to Qt.io
Contact Us Blog Download Qt

QNode Class

class Qt3DCore::QNode

QNode ist die Basisklasse für alle Qt3D-Knotenklassen, die zum Aufbau einer Qt3D-Szene verwendet werden. Mehr...

Kopfzeile: #include <QNode>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3DCore)
target_link_libraries(mytarget PRIVATE Qt6::3DCore)
qmake: QT += 3dcore
Vererbt: QObject
Geerbt von:
32 Typen

Qt3DAnimation::QAbstractAnimationClip, Qt3DAnimation::QAbstractClipBlendNode, Qt3DAnimation::QChannelMapper, Qt3DCore::QAbstractSkeleton, Qt3DCore::QAttribute, Qt3DCore::QBuffer, Qt3DCore::QComponent, Qt3DCore::QEntity, Qt3DCore::QGeometry, Qt3DCore::QGeometryView, Qt3DCore::QJoint, Qt3DInput::QAbstractActionInput, Qt3DInput::QAbstractAxisInput, Qt3DInput::QAbstractPhysicalDevice, Qt3DInput::QAction, Qt3DInput::QAxis, Qt3DInput::QAxisSetting, Qt3DRender::QAbstractTexture, Qt3DRender::QAbstractTextureImage, Qt3DRender::QEffect, Qt3DRender::QFilterKey, Qt3DRender::QFrameGraphNode, Qt3DRender::QParameter, Qt3DRender::QPickingSettings, Qt3DRender::QRenderPass, Qt3DRender::QRenderState, Qt3DRender::QRenderTargetOutput, Qt3DRender::QShaderImage, Qt3DRender::QShaderProgram, Qt3DRender::QShaderProgramBuilder, Qt3DRender::QTechnique, und Qt3DRender::Quick::QScene2D

Status: Deprecated

Eigenschaften

Öffentliche Funktionen

QNode(Qt3DCore::QNode *parent = nullptr)
bool blockNotifications(bool block)
Qt3DCore::QNodeVector childNodes() const
Qt3DCore::QNodeId id() const
bool isEnabled() const
bool notificationsBlocked() const
Qt3DCore::QNode *parentNode() const

Öffentliche Slots

void setEnabled(bool isEnabled)
void setParent(Qt3DCore::QNode *parent)

Signale

void enabledChanged(bool enabled)
void nodeDestroyed()
void parentChanged(QObject *parent)
QNodePtr
QNodeVector
Qt3DCore::QNodeId qIdForNode(Qt3DCore::QNode *node)
Qt3DCore::QNodeIdVector qIdsForNodes(const T &nodes)

Detaillierte Beschreibung

Die Zugehörigkeit zu QNode wird durch die QObject Eltern-Kind-Beziehung zwischen den Knoten bestimmt. An sich hat ein QNode kein visuelles Erscheinungsbild und keine besondere Bedeutung, er ist dazu da, eine knotenbasierte Baumstruktur aufzubauen.

Das Elternteil einer QNode-Instanz kann nur eine andere QNode-Instanz sein.

Jede QNode-Instanz hat eine eindeutige ID, die es ermöglicht, sie von anderen Instanzen zu unterscheiden.

Wenn Eigenschaften auf einer QNode Unterklasse definiert sind, wird ihr NOTIFY Signal automatisch Benachrichtigungen generieren, die die Qt3D Backend Aspekte empfangen.

Siehe auch QEntity und QComponent.

Dokumentation der Eigenschaften

enabled : bool

Enthält das Kennzeichen QNode aktiviert. Standardmäßig ist eine QNode immer aktiviert.

Hinweis: Die Interpretation dessen, was enabled bedeutet, ist aspektabhängig. Auch wenn enabled auf false gesetzt ist, können einige Aspekte den Knoten in irgendeiner Weise berücksichtigen. Dies ist für jede Klasse einzeln dokumentiert.

Zugriffsfunktionen:

bool isEnabled() const
void setEnabled(bool isEnabled)

Melder-Signal:

void enabledChanged(bool enabled)

parent : Qt3DCore::QNode*

Enthält den unmittelbaren QNode Elternteil oder null, wenn der Knoten keinen Elternteil hat.

Das Setzen des Elternteils wird die Backend-Aspekte über die Änderung des Elternteils der aktuellen QNode Instanz informieren.

Hinweis: wenn parent zufällig null ist, wird dies tatsächlich mitteilen, dass die aktuelle QNode Instanz aus der Szene entfernt wurde.

Zugriffsfunktionen:

Qt3DCore::QNode *parentNode() const
void setParent(Qt3DCore::QNode *parent)

Notifier Signal:

void parentChanged(QObject *parent)

Member Function Dokumentation

[explicit] QNode::QNode(Qt3DCore::QNode *parent = nullptr)

Erzeugt eine neue QNode Instanz mit Parent parent.

Hinweis: Die Backend-Aspekte werden nur benachrichtigt, dass eine QNode-Instanz Teil der Szene ist, wenn sie einen Elternteil hat; es sei denn, dies ist der Wurzelknoten der Qt3D-Szene.

Siehe auch setParent().

bool QNode::blockNotifications(bool block)

Wenn block gleich true ist, werden die von diesem Objekt an Aspekte gesendeten Benachrichtigungen über Eigenschaftsänderungen blockiert. Wenn block gleich false ist, wird keine solche Blockierung erfolgen.

Der Rückgabewert ist der vorherige Wert von notificationsBlocked().

Beachten Sie, dass die anderen Benachrichtigungsarten gesendet werden, auch wenn die Benachrichtigungen für dieses Objekt blockiert wurden.

Siehe auch notificationsBlocked().

Qt3DCore::QNodeVector QNode::childNodes() const

Gibt eine Liste mit den QNode Kindern der aktuellen QNode Instanz zurück.

Qt3DCore::QNodeId QNode::id() const

Gibt die ID zurück, die die Instanz QNode eindeutig identifiziert.

[signal] void QNode::nodeDestroyed()

Wird ausgegeben, wenn der Knoten zerstört wird.

bool QNode::notificationsBlocked() const

Gibt true zurück, wenn Aspekt-Benachrichtigungen blockiert sind; andernfalls gibt es false zurück. Standardmäßig werden Benachrichtigungen nicht blockiert.

Siehe auch blockNotifications().

Verwandte Nicht-Mitglieder

[alias] QNodePtr

Ein gemeinsamer Zeiger für QNode.

[alias] QNodeVector

Liste von QNode Zeigern.

Qt3DCore::QNodeId qIdForNode(Qt3DCore::QNode *node)

Gibt die Knoten-ID für node zurück.

template <typename T> Qt3DCore::QNodeIdVector qIdsForNodes(const T &nodes)

Gibt den Vektor der Knoten-IDs für nodes zurück.

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