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

QGraphicsObject Class

QGraphicsObject 클래스는 시그널, 슬롯 및 속성이 필요한 모든 그래픽 항목에 대한 기본 클래스를 제공합니다. 더 보기...

헤더: #include <QGraphicsObject>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
상속:QObject 그리고 QGraphicsItem
상속받는 항목:

QGraphicsSvgItem, QGraphicsTextItem 및 QGraphicsWidget

속성

공개 함수

QGraphicsObject(QGraphicsItem *parent = nullptr)
virtual ~QGraphicsObject()
void grabGesture(Qt::GestureType gesture, Qt::GestureFlags flags = Qt::GestureFlags())
void ungrabGesture(Qt::GestureType gesture)

신호

void enabledChanged()
void opacityChanged()
void parentChanged()
void rotationChanged()
void scaleChanged()
void visibleChanged()
void xChanged()
void yChanged()
void zChanged()

재구현된 보호된 함수

virtual bool event(QEvent *ev) override

보호된 슬롯

void updateMicroFocus()

상세 설명

이 클래스는 QGraphicsItem 를 확장하며, QObject 의 신호/슬롯 및 속성 메커니즘을 포함합니다. 이 클래스는 QGraphicsItem 의 기본 세터 및 게터 중 상당수를 속성에 매핑하고, 그중 다수에 대해 알림 신호를 추가합니다.

부모 및 자식

각 그래픽 객체는 부모 항목을 지정하여 생성할 수 있습니다. 이를 통해 부모 항목이 소멸될 때 해당 항목도 소멸되도록 보장합니다. QGraphicsObject는 QObject 와 QGraphicsItem 를 모두 상속받지만, 부모와 자식 항목 간의 관계를 관리할 때는 QObject 가 아닌 QGraphicsItem 에서 제공하는 함수를 사용해야 합니다.

항목 간의 관계는 parentItem() 및 childItems() 함수를 사용하여 확인할 수 있습니다. 씬 내 항목의 계층 구조에서, parentObject() 및 parentWidget() 함수는 QWidget 의 하위 클래스에 대한 QWidget::parent() 및 QWidget::parentWidget() 함수와 동일합니다.

QGraphicsWidget도 참조하십시오 .

속성 문서

effect : QGraphicsEffect*

이 속성은 해당 항목에 적용된 효과를 저장합니다.

QGraphicsItem::setGraphicsEffect() 및 QGraphicsItem::graphicsEffect()도 참조하십시오 .

enabled : bool

이 속성은 항목이 활성화되어 있는지 여부와 관계없이 적용됩니다.

이 속성은 ` QGraphicsItem`에서 선언됩니다.

기본적으로 이 속성의 값은 ` true`입니다.

알림 신호:

void enabledChanged()

QGraphicsItem::isEnabled() 및 QGraphicsItem::setEnabled()도 참조하십시오 .

opacity : qreal

이 속성은 항목의 불투명도를 나타냅니다.

알림 신호:

void opacityChanged()

QGraphicsItem::setOpacity() 및 QGraphicsItem::opacity()도 참조하십시오 .

parent : QGraphicsObject*

이 속성은 항목의 상위 항목을 저장합니다.

참고: 항목 의 상위항목은 ` QObject::parent()` 함수가 반환하는 상위 객체와는 별도로 설정됩니다.

알림 신호:

void parentChanged()

QGraphicsItem::setParentItem() 및 QGraphicsItem::parentObject()도 참조하십시오 .

pos : QPointF

이 속성은 항목의 위치를 나타냅니다.

항목의 위치를 설명합니다.

QGraphicsItem::setPos() 및 QGraphicsItem::pos()도 참조하십시오 .

rotation : qreal

이 속성은 항목의 회전 각도를 도(°) 단위로 저장합니다.

이 속성은 항목이 transformOrigin을 중심으로 몇 도만큼 회전할지 지정합니다. 기본 회전 각도는 0도입니다(즉, 전혀 회전하지 않음).

알림 신호:

void rotationChanged()

scale : qreal

이 속성은 항목의 크기를 지정합니다.

배율이 1보다 작으면 항목이 평소보다 작게 표시되고, 1보다 크면 평소보다 크게 표시됩니다. 음수 배율은 항목이 거울처럼 반전되어 표시됨을 의미합니다.

기본적으로 아이템은 배율 1(즉, 정상 크기)로 표시됩니다.

크기 조정은 항목의 transformOrigin을 기준으로 이루어집니다.

알림 신호:

void scaleChanged()

transformOriginPoint : QPointF

이 속성은 변환 원점을 지정합니다.

이 속성은 항목의 좌표계 내 특정 점을 크기 조정 및 회전의 원점으로 설정합니다.

scale, rotation 및 QGraphicsItem::transformOriginPoint()도 참조하십시오 .

visible : bool

이 속성은 항목이 표시되는지 여부와 관계없이 적용됩니다.

이 속성은 ` QGraphicsItem`에서 선언됩니다.

기본적으로 이 속성의 값은 ` true`입니다.

알림 신호:

void visibleChanged()

QGraphicsItem::isVisible() 및 QGraphicsItem::setVisible()도 참조하십시오 .

x : qreal

이 속성은 항목의 x 좌표를 나타냅니다.

항목의 x 좌표를 나타냅니다.

알림 신호:

void xChanged()

QGraphicsItem::setX() 및 setPos()도 참조하십시오 .

y : qreal

이 속성은 항목의 y 좌표를 저장합니다.

항목의 y 좌표를 나타냅니다.

알림 신호:

void yChanged()

QGraphicsItem::setY() 및 setPos()도 참조하십시오 .

z : qreal

이 속성은 항목의 z 값을 저장합니다

아이템의 z 값을 나타냅니다.

알림 신호:

void zChanged()

QGraphicsItem::setZValue() 및 zValue()도 참조하십시오 .

멤버 함수 문서

[explicit] QGraphicsObject::QGraphicsObject(QGraphicsItem *parent = nullptr)

parent 를 사용하여 QGraphicsObject를 생성합니다.

[virtual noexcept] QGraphicsObject::~QGraphicsObject()

소멸자.

[signal] void QGraphicsObject::enabledChanged()

이 신호는 항목이 활성화되거나 비활성화될 때마다 발생합니다.

참고: 속성 enabled 에 대한Notifier 신호입니다.

isEnabled()도 참조하십시오 .

[override virtual protected] bool QGraphicsObject::event(QEvent *ev)

QObject::event(QEvent *e)를 재구현합니다.

void QGraphicsObject::grabGesture(Qt::GestureType gesture, Qt::GestureFlags flags = Qt::GestureFlags())

지정된 gesture 에 특정 flags 를 사용하여 그래픽스 객체를 등록합니다.

ungrabGesture() 및 QGestureEvent도 참조하십시오 .

[signal] void QGraphicsObject::opacityChanged()

이 항목의 불투명도가 변경될 때마다 이 신호가 발생합니다.

참고: 속성 opacity 에 대한Notifier 신호입니다.

QGraphicsItem::opacity()도 참조하십시오 .

[signal] void QGraphicsObject::parentChanged()

이 신호는 항목의 상위 항목이 변경될 때마다 발생합니다.

참고: 속성 ` parent`에 대한Notifier 신호입니다.

[signal] void QGraphicsObject::rotationChanged()

이 신호는 아이템의 회전 방향이 바뀔 때마다 발생합니다.

참고: 속성 ` rotation`에 대한Notifier 신호입니다.

[signal] void QGraphicsObject::scaleChanged()

이 신호는 항목의 크기가 변경될 때 발생합니다.

참고: 속성 ` scale`에 대한알림 신호입니다.

void QGraphicsObject::ungrabGesture(Qt::GestureType gesture)

지정된 gesture 에서 그래픽스 객체의 구독을 해제합니다.

grabGesture() 및 QGestureEvent도 참조하십시오 .

[protected slot] void QGraphicsObject::updateMicroFocus()

아이템의 마이크로 포커스를 업데이트합니다. 이 슬롯은 편의상 마련된 것입니다.

QInputMethod도 참조하십시오 .

[signal] void QGraphicsObject::visibleChanged()

이 신호는 항목의 표시 상태가 변경될 때마다 발생합니다.

참고: 속성 ` visible`에 대한Notifier 신호입니다.

visible도 참조하십시오 .

[signal] void QGraphicsObject::xChanged()

이 항목의 x 좌표가 변경될 때마다 이 신호가 발생합니다.

참고: 속성 x 에 대한Notifier 신호입니다.

pos()도 참조하십시오 .

[signal] void QGraphicsObject::yChanged()

이 신호는 항목의 y 좌표가 변경될 때마다 발생합니다.

참고: 속성 ` y`에 대한Notifier 신호입니다.

pos()도 참조하십시오 .

[signal] void QGraphicsObject::zChanged()

이 신호는 항목의 z 값이 변경될 때마다 발생합니다.

참고: 속성 ` z`에 대한Notifier 신호입니다.

pos()도 참조하십시오 .

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