Back to Qt.io
Contact Us Blog Download Qt
이 페이지에서

Qt3DCore::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, 그리고 Qt3DRender::Quick::QScene2D

상태: 사용 중단됨

이 클래스는 사용 중단되었습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.

속성

공개 함수

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 자체는 시각적인 형태도 없고 특별한 의미도 없으며, 노드 기반 트리 구조를 구축하기 위한 수단으로 존재합니다.

QNode 인스턴스의 부모는 다른 QNode 인스턴스일 수밖에 없습니다.

각 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)

Notifier 시그널:

void parentChanged(QObject *parent)

멤버 함수 문서

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

parent 를 부모로 하는 새로운 QNode 인스턴스를 생성합니다.

참고: QNode 인스턴스가 Qt3D 씬의 루트 노드가 아닌 경우, 부모 노드가 있어야만 해당 인스턴스가 씬의 일부임을백엔드 측에 알립니다.

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 벡터를 반환합니다.

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