Back to Qt.io
Contact Us Blog Download Qt

QNode Class

class Qt3DCore::QNode

QNode는 Qt3D 씬을 빌드하는 데 사용되는 모든 Qt3D 노드 클래스의 베이스 클래스입니다. 더 보기...

헤더: #include <QNode>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3DCore)
target_link_libraries(mytarget PRIVATE Qt6::3DCore)
qmake: QT += 3dcore
상속합니다: QObject
상속 대상:
32 종류

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, and Qt3DRender::Quick::QScene2D

Status: Deprecated

속성

공용 기능

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

공용 슬롯

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

신호

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

상세 설명

QNode의 소유권은 노드 간의 QObject 부모/자식 관계에 의해 결정됩니다. QNode는 그 자체로는 시각적인 모양이나 특별한 의미가 없으며, 노드 기반 트리 구조를 구축하기 위한 방법으로 존재합니다.

Q노드 인스턴스의 부모는 다른 Q노드 인스턴스만 될 수 있습니다.

각 QNode 인스턴스에는 다른 인스턴스에서 식별할 수 있는 고유 ID가 있습니다.

프로퍼티가 QNode 서브클래스에 정의되면 해당 프로퍼티의 NOTIFY 신호가 자동으로 Qt3D 백엔드 측면이 수신할 알림을 생성합니다.

QEntity 및 QComponent 을참조하십시오 .

프로퍼티 문서

enabled : bool

QNode 활성화 플래그를 보유합니다. 기본적으로 QNode 은 항상 활성화되어 있습니다.

참고: 활성화된 의미에 대한 해석은 측면에 따라 다릅니다. 활성화가 false 로 설정되어 있더라도 일부 측면에서는 여전히 어떤 방식으로 노드를 고려할 수 있습니다. 이는 클래스별로 문서화되어 있습니다.

액세스 함수:

bool isEnabled() const
void setEnabled(bool isEnabled)

알림 신호:

void enabledChanged(bool enabled)

parent : Qt3DCore::QNode*

노드에 부모가 없는 경우 바로 QNode 부모를 보유하거나 null을 보유합니다.

부모를 설정하면 현재 QNode 인스턴스의 부모가 변경되었음을 백엔드 측면에 알립니다.

참고: parent 이 null인 경우, 실제로는 현재 QNode 인스턴스가 씬에서 제거되었음을 알립니다.

액세스 함수:

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

알림 신호:

void parentChanged(QObject *parent)

멤버 함수 문서

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

parent 을 부모로 하는 새 Q노드 인스턴스를 생성합니다.

참고: 백엔드 측면은 Qt3D 씬의 루트 노드가 아닌 경우, 부모가 있는 경우에만 Q노드 인스턴스가 씬의 일부라는 것을 알립니다.

setParent()도 참조하십시오 .

bool QNode::blockNotifications(bool block)

block 이 true 인 경우 이 객체가 측면으로 보내는 속성 변경 알림이 차단됩니다. block 가 false 인 경우 이러한 차단이 발생하지 않습니다.

반환 값은 notificationsBlocked()의 이전 값입니다.

이 개체에 대한 알림이 차단된 경우에도 다른 알림 유형은 전송됩니다.

notificationsBlocked()도 참조하세요 .

Qt3DCore::QNodeVector QNode::childNodes() const

현재 QNode 인스턴스의 QNode 자식들로 채워진 목록을 반환합니다.

Qt3DCore::QNodeId QNode::id() const

QNode 인스턴스를 고유하게 식별하는 ID를 반환합니다.

[signal] void QNode::nodeDestroyed()

노드가 파괴될 때 발생하는 이벤트입니다.

bool QNode::notificationsBlocked() const

측면 알림이 차단된 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다. 기본적으로 알림은 차단되지 않습니다.

blockNotifications()도 참조하세요 .

관련 비회원

[alias] QNodePtr

QNode 에 대한 공유 포인터입니다.

[alias] QNodeVector

QNode 포인터 목록.

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

node 에 대한 노드 ID를 반환합니다.

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

nodes 에 대한 노드 ID 벡터를 반환합니다.

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