QQuickItem Class

멤버 함수 설명서

[explicit] QQuickItem::QQuickItem(QQuickItem *parent = nullptr)

지정된 ` parent`을 사용하여 `QQuickItem`을 생성합니다.

parent 는 visual parent 과 QObject 의 부모로 모두 사용됩니다.

[override virtual noexcept] QQuickItem::~QQuickItem()

QQuickItem 를 삭제합니다.

bool QQuickItem::acceptHoverEvents() const

이 항목이 호버 이벤트를 허용하는지 여부를 반환합니다.

기본값은 false입니다.

이 값이 false인 경우, 해당 항목은 hoverEnterEvent(), hoverMoveEvent() 및 hoverLeaveEvent() 함수를 통해 호버 이벤트를 수신하지 않습니다.

setAcceptHoverEvents()도 참조하십시오 .

bool QQuickItem::acceptTouchEvents() const

이 항목이 터치 이벤트를 수락하는지 여부를 반환합니다.

기본값은 ` false`입니다.

이 값이 false 인 경우, 해당 아이템은 touchEvent() 함수를 통해 터치 이벤트를 수신하지 않습니다.

setAcceptTouchEvents()도 참조하십시오 .

Qt::MouseButtons QQuickItem::acceptedMouseButtons() const

이 항목에서 허용하는 마우스 버튼을 반환합니다.

기본값은 ` Qt::NoButton`이며, 이는 어떤 마우스 버튼도 허용하지 않음을 의미합니다.

항목이 특정 마우스 이벤트에 대한 마우스 버튼을 허용하지 않는 경우, 해당 마우스 이벤트는 해당 항목으로 전달되지 않고 대신 항목 계층 구조에서 다음 항목으로 전달됩니다.

setAcceptedMouseButtons() 및 acceptTouchEvents()도 참조하십시오 .

[virtual] QRectF QQuickItem::boundingRect() const

해당 항목의 자체 좌표계에서 항목의 범위를 반환합니다. 즉, 0, 0 에서 width()까지, 그리고 height()까지를 포함하는 직사각형입니다.

[invokable] QQuickItem *QQuickItem::childAt(qreal x, qreal y) const

이 항목의 좌표계 내에서 (x, y) 지점에서 발견된 첫 번째 표시된 자식 항목을 반환합니다.

해당 항목이 없는 경우 nullptr 을 반환합니다.

QList<QQuickItem *> QQuickItem::childItems() const

이 항목의 자식 노드를 반환합니다.

[virtual protected] bool QQuickItem::childMouseEventFilter(QQuickItem *item, QEvent *event)

이 메서드를 재구현하여 이 항목의 자식 요소들이 수신하는 포인터 이벤트를 필터링하십시오.

이 메서드는 filtersChildMouseEvents()이 true 인 경우에만 호출됩니다.

지정된 event 가 지정된 자식 item 으로 전달되어서는 안 되는 경우 true 를 반환하고, 그 외의 경우에는 false 를 반환하십시오. true 를 반환하는 경우, 이벤트 전파를 중지할지 계속할지 신호를 보내기 위해 event 에 accept 또는 ignore 를 수행해야 합니다. 그러나 event 는 항상 부모 체인을 따라 위쪽의 모든 childMouseEventFilter로 전송됩니다.

setFiltersChildMouseEvents()도 참조하십시오 .

[override virtual protected] void QQuickItem::classBegin()

QQmlParserStatus::classBegin()을 재구현합니다.

파생 클래스는 classBegin에서 자체 액션을 추가하기 전에 기본 클래스의 메서드를 호출해야 합니다.

[virtual] QRectF QQuickItem::clipRect() const

뷰포트(viewport)가 있고 ‘ ItemObservesViewport ’ 플래그가 설정된 경우, ` viewportItem()`에서 현재 표시되고 있는 이 항목 내의 직사각형 영역을 반환합니다. 그렇지 않은 경우, 이 항목의 자체 좌표계에서의 범위, 즉 ` 0, 0 `에서 ` width()`까지 및 ` height()`에 이르는 직사각형을 반환합니다. 이는 ` clip `가 ` true`인 경우 계속 표시되도록 의도된 영역입니다. 또한 ` updatePaintNode()`에서 사용되어 장면 그래프에 추가되는 그래픽을 제한할 수도 있습니다.

예를 들어, 애플리케이션 창의 일부만 차지하는 Flickable에 큰 그림이나 큰 텍스트 문서가 표시될 수 있습니다. 이 경우 Flickable이 뷰포트 항목이 되며, 사용자 정의 콘텐츠 렌더링 항목은 현재 표시된 영역 밖에 있는 씬 그래프 노드를 생략하도록 선택할 수 있습니다. ItemObservesViewport 플래그가 설정된 경우, 이 영역은 사용자가 Flickable 내의 콘텐츠를 스크롤할 때마다 변경됩니다.

중첩된 뷰포트 항목의 경우, clipRect()는 ‘ ItemIsViewport ’ 플래그가 설정된 모든 상위 항목의 ‘ boundingRect’ 간의 교집합이며, 이 항목의 좌표계로 매핑됩니다.

boundingRect()도 참조하십시오 .

[override virtual protected] void QQuickItem::componentComplete()

QQmlParserStatus::componentComplete()을 재구현합니다.

파생 클래스는 componentComplete에서 수행할 자체 동작을 추가하기 전에 기본 클래스의 메서드를 호출해야 합니다.

[virtual invokable] bool QQuickItem::contains(const QPointF &point) const

이 아이템에 로컬 좌표계의 ` point`가 포함되어 있으면 ` true `를 반환하고, 그렇지 않으면 ` false `를 반환합니다.

이 함수는 사용자 정의 모양을 가진 아이템에서 점 충돌을 처리하기 위해 재정의할 수 있습니다. 기본 구현은 containmentMask()이 설정된 경우 해당 범위 내에 점이 있는지, 그렇지 않은 경우 바운딩 박스 내에 점이 있는지 확인합니다.

QCursor QQuickItem::cursor() const

이 항목에 대한 커서 모양을 반환합니다.

별도의 커서 재정의가 설정되어 있지 않은 한, 마우스 커서가 이 항목 위에 위치하면 이 모양을 띱니다. 유용한 다양한 모양에 대해서는 list of predefined cursor objects 를 참조하십시오.

커서 모양이 설정되지 않은 경우, 이 함수는 Qt::ArrowCursor 모양의 커서를 반환하지만, 중복되는 항목에 유효한 커서가 있는 경우 다른 커서 모양이 표시될 수 있습니다.

setCursor() 및 unsetCursor()도 참조하십시오 .

[virtual protected] void QQuickItem::dragEnterEvent(QDragEnterEvent *event)

이 이벤트 핸들러는 하위 클래스에서 재구현하여 항목에 대한 drag-enter 이벤트를 수신할 수 있습니다. 이벤트 정보는 event 매개변수를 통해 제공됩니다.

드래그 앤 드롭 이벤트는 해당 항목에 대해 ItemAcceptsDrops 플래그가 설정된 경우에만 제공됩니다.

이 이벤트는 기본적으로 수락되므로, 이 함수를 재구현할 때 이벤트를 명시적으로 수락할 필요는 없습니다. 이벤트를 수락하지 않으려면 event->ignore() 를 호출하십시오.

Drag 및 드래그 앤 드롭항목도 참조하십시오.

[virtual protected] void QQuickItem::dragLeaveEvent(QDragLeaveEvent *event)

이 이벤트 핸들러는 하위 클래스에서 재구현하여 항목에 대한 드래그 이탈(drag-leave) 이벤트를 수신할 수 있습니다. 이벤트 정보는 ` event ` 매개변수를 통해 제공됩니다.

드래그 앤 드롭 이벤트는 해당 항목에 대해 ItemAcceptsDrops 플래그가 설정된 경우에만 제공됩니다.

이 이벤트는 기본적으로 수락되므로, 이 함수를 재구현할 때 이벤트를 명시적으로 수락할 필요는 없습니다. 이벤트를 수락하지 않으려면 event->ignore() 를 호출하십시오.

Drag 및 드래그 앤 드롭항목도 참조하십시오.

[virtual protected] void QQuickItem::dragMoveEvent(QDragMoveEvent *event)

이 이벤트 핸들러는 하위 클래스에서 재구현하여 항목에 대한 드래그 이동 이벤트를 수신할 수 있습니다. 이벤트 정보는 ` event ` 매개변수를 통해 제공됩니다.

드래그 앤 드롭 이벤트는 해당 항목에 대해 ItemAcceptsDrops 플래그가 설정된 경우에만 제공됩니다.

이 이벤트는 기본적으로 수락되므로, 이 함수를 재구현할 때 이벤트를 명시적으로 수락할 필요는 없습니다. 이벤트를 수락하지 않으려면 event->ignore() 을 호출하십시오.

Drag 및 드래그 앤 드롭항목도 참조하십시오.

[virtual protected] void QQuickItem::dropEvent(QDropEvent *event)

이 이벤트 핸들러는 하위 클래스에서 재구현하여 항목에 대한 드롭 이벤트를 수신할 수 있습니다. 이벤트 정보는 ` event ` 매개변수를 통해 제공됩니다.

드래그 앤 드롭 이벤트는 해당 항목에 대해 ItemAcceptsDrops 플래그가 설정된 경우에만 제공됩니다.

이 이벤트는 기본적으로 수락되므로, 이 함수를 재구현할 때 이벤트를 명시적으로 수락할 필요는 없습니다. 이벤트를 수락하지 않으려면 event->ignore() 를 호출하십시오.

Drag 및 드래그 앤 드롭항목도 참조하십시오.

[invokable, since 6.3] void QQuickItem::dumpItemTree() const

이 항목을 시작으로 항목들의 시각적 트리에 대한 세부 정보를 재귀적으로 출력합니다.

이 함수는 Qt 6.3에서 도입되었습니다.

‘디버깅 기법 ’ 및 GammaRay의 Qt Quick Inspector도 참조하십시오 .

[invokable, since 6.3] void QQuickItem::ensurePolished()

updatePolish()를 호출합니다

이는 PolishEvent를 수신할 때까지 implicitWidth 및 implicitHeight 계산을 지연시키는 레이아웃(또는 포지셔너)과 같은 항목에 유용할 수 있습니다.

일반적으로, 예를 들어 레이아웃에 자식 항목이 추가되거나 제거되더라도 암시적 크기는 즉시 계산되지 않습니다(이는 최적화 때문입니다). 경우에 따라 자식 항목이 추가된 직후 레이아웃의 암시적 크기를 조회해야 할 수도 있습니다. 이 경우, 암시적 크기를 조회하기 직전에 이 함수를 사용하십시오.

이 함수는 Qt 6.3에서 도입되었습니다.

updatePolish() 및 polish()도 참조하십시오 .

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

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

bool QQuickItem::filtersChildMouseEvents() const

이 항목의 자식 항목을 대상으로 하는 포인터 이벤트를 이 항목을 통해 필터링해야 하는지 여부를 반환합니다.

이 항목과 자식 항목 모두 ` acceptTouchEvents()` true 를 설정해 둔 경우, 터치 상호작용이 발생하면 이 항목이 터치 이벤트를 필터링합니다. 하지만 이 항목이나 자식 항목 중 하나라도 터치 이벤트를 처리할 수 없는 경우, ` childMouseEventFilter()`가 합성된 마우스 이벤트와 함께 호출됩니다.

setFiltersChildMouseEvents() 및 childMouseEventFilter()도 참조하십시오 .

QQuickItem::Flags QQuickItem::flags() const

이 항목에 대한 항목 플래그를 반환합니다.

setFlags() 및 setFlag()도 참조하십시오 .

[virtual protected] void QQuickItem::focusInEvent(QFocusEvent *event)

이 이벤트 핸들러는 하위 클래스에서 재구현하여 특정 항목에 대한 포커스 인(focus-in) 이벤트를 수신할 수 있습니다. 이벤트 정보는 ` event ` 매개변수를 통해 제공됩니다.

이 이벤트는 기본적으로 수락되므로, 이 함수를 재구현할 때 이벤트를 명시적으로 수락할 필요는 없습니다. 이벤트를 수락하지 않으려면 event->ignore() 을 호출하십시오.

이 함수를 재구현하는 경우, 기본 클래스의 구현을 호출해야 합니다.

[virtual protected] void QQuickItem::focusOutEvent(QFocusEvent *event)

이 이벤트 핸들러는 하위 클래스에서 재구현하여 항목의 포커스 이탈 이벤트를 수신할 수 있습니다. 이벤트 정보는 ` event ` 매개변수를 통해 제공됩니다.

이 이벤트는 기본적으로 수락되므로, 이 함수를 재구현할 때 이벤트를 명시적으로 수락할 필요는 없습니다. 이벤트를 수락하지 않으려면 event->ignore() 를 호출하십시오.

[invokable] void QQuickItem::forceActiveFocus()

해당 항목에 활성 포커스를 설정합니다.

이 메서드는 항목에 포커스를 설정하고, 객체 계층 구조 내의 모든 상위 FocusScope 객체에도 focus 가 전달되도록 보장합니다.

포커스 변경 이유는 Qt::OtherFocusReason 가 됩니다. 포커스 변경을 더 효과적으로 처리하려면 오버로드된 메서드를 사용하여 포커스 변경 이유를 지정하십시오.

activeFocus도 참조하십시오 .

[invokable] void QQuickItem::forceActiveFocus(Qt::FocusReason reason)

지정된 reason 를 가진 항목에 포커스를 강제적으로 설정합니다.

이 메서드는 해당 항목에 포커스를 설정하고, 객체 계층 구조 내의 모든 상위 FocusScope 객체에도 focus 가 설정되도록 보장합니다.

activeFocus 및 Qt::FocusReason도 참조하십시오 .

[virtual protected, since 6.0] void QQuickItem::geometryChange(const QRectF &newGeometry, const QRectF &oldGeometry)

이 함수는 oldGeometry 에서 newGeometry 로 이 항목의 지오메트리 변경 사항을 처리하기 위해 호출됩니다. 두 지오메트리가 동일한 경우, 아무 작업도 수행하지 않습니다.

파생 클래스는 자체 구현 내에서 기본 클래스의 메서드를 호출해야 합니다.

이 함수는 Qt 6.0에서 도입되었습니다.

QSharedPointer<QQuickItemGrabResult> QQuickItem::grabToImage(const QSize &targetSize = QSize())

항목을 메모리 내 이미지로 가져옵니다.

이 작업은 비동기적으로 수행되며, 작업이 완료되면 QQuickItemGrabResult::ready() 신호가 발생합니다.

targetSize 를 사용하여 대상 이미지의 크기를 지정합니다. 기본적으로 결과 이미지의 크기는 item과 동일합니다.

캡처를 시작할 수 없는 경우, 이 함수는 null 를 반환합니다.

QQuickWindow::grabWindow()도 참조하십시오 .

[protected] bool QQuickItem::heightValid() const

height 속성이 명시적으로 설정되었는지 여부를 반환합니다.

[virtual protected] void QQuickItem::hoverEnterEvent(QHoverEvent *event)

이 이벤트 핸들러는 하위 클래스에서 재구현하여 항목의 호버 진입(hover-enter) 이벤트를 수신할 수 있습니다. 이벤트 정보는 ` event ` 매개변수를 통해 제공됩니다.

acceptHoverEvents()의 값이 true인 경우에만 호버 이벤트가 제공됩니다.

이 이벤트는 기본적으로 수락되므로, 이 함수를 재구현할 때 이벤트를 명시적으로 수락할 필요는 없습니다. 이벤트를 수락하지 않으려면 event->ignore() 를 호출하십시오.

[virtual protected] void QQuickItem::hoverLeaveEvent(QHoverEvent *event)

이 이벤트 핸들러는 하위 클래스에서 재구현하여 항목에 대한 호버-리브(hover-leave) 이벤트를 수신할 수 있습니다. 이벤트 정보는 event 매개변수를 통해 제공됩니다.

acceptHoverEvents()의 값이 true인 경우에만 호버 이벤트가 제공됩니다.

이 이벤트는 기본적으로 수락되므로, 이 함수를 재구현할 때 이벤트를 명시적으로 수락할 필요는 없습니다. 이벤트를 수락하지 않으려면 event->ignore() 을 호출하십시오.

[virtual protected] void QQuickItem::hoverMoveEvent(QHoverEvent *event)

이 이벤트 핸들러는 하위 클래스에서 재구현하여 항목에 대한 호버 이동 이벤트를 수신할 수 있습니다. 이벤트 정보는 event 매개변수를 통해 제공됩니다.

acceptHoverEvents()의 값이 true인 경우에만 호버 이벤트가 제공됩니다.

이 이벤트는 기본적으로 수락되므로, 이 함수를 재구현할 때 이벤트를 명시적으로 수락할 필요는 없습니다. 이벤트를 수락하지 않으려면 event->ignore() 를 호출하십시오.

qreal QQuickItem::implicitWidth() const

콘텐츠를 결정하는 다른 속성들에 의해 암시되는 항목의 너비를 반환합니다.

setImplicitWidth()도 참조하십시오 .

[virtual protected] void QQuickItem::inputMethodEvent(QInputMethodEvent *event)

이 이벤트 핸들러는 하위 클래스에서 재구현하여 항목에 대한 입력 방법 이벤트를 수신할 수 있습니다. 이벤트 정보는 ` event ` 매개변수를 통해 제공됩니다.

이벤트는 기본적으로 수락되므로, 이 함수를 재구현할 때 이벤트를 명시적으로 수락할 필요는 없습니다. 이벤트를 수락하지 않으려면 event->ignore() 를 호출하십시오.

[virtual] QVariant QQuickItem::inputMethodQuery(Qt::InputMethodQuery query) const

이 메서드는 입력 항목에만 적용됩니다.

이 항목이 입력 항목인 경우, 이 메서드는 주어진 ` query`에 대한 관련 입력 방법 플래그를 반환하도록 재구현되어야 합니다.

QWidget::inputMethodQuery()도 참조하십시오 .

bool QQuickItem::isAncestorOf(const QQuickItem *child) const

이 항목이 child 의 조상인 경우(즉, 이 항목이 child 의 부모이거나, child 의 부모 중 한 명의 조상인 경우) true 를 반환합니다.

parentItem()도 참조하십시오 .

[protected] bool QQuickItem::isComponentComplete() const

QML 컴포넌트의 생성 과정이 완료되면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

종종 컴포넌트가 완성될 때까지 일부 처리를 지연시키는 것이 바람직합니다.

componentComplete()도 참조하십시오 .

bool QQuickItem::isFocusScope() const

이 항목이 포커스 스코프인 경우 true를 반환하고, 그렇지 않은 경우 false를 반환합니다.

[virtual] bool QQuickItem::isTextureProvider() const

이 항목이 텍스처 제공자인 경우 true를 반환합니다. 기본 구현은 false를 반환합니다.

이 함수는 어떤 스레드에서든 호출할 수 있습니다.

[virtual protected] void QQuickItem::itemChange(QQuickItem::ItemChange change, const QQuickItem::ItemChangeData &value)

이 항목에 대해 ‘ change ’가 발생할 때 호출됩니다.

value 해당하는 경우, 변경 사항과 관련된 추가 정보가 포함됩니다.

하위 클래스에서 이 메서드를 재구현하는 경우,

QQuickItem::itemChange(change, value);

windowChanged() 신호가 정상적으로 발송되도록 하십시오.

bool QQuickItem::keepMouseGrab() const

마우스 입력이 이 항목에만 국한되어야 하는지 여부를 반환합니다.

setKeepMouseGrab(), QEvent::accept(), QEvent::ignore()도 참조하십시오 .

bool QQuickItem::keepTouchGrab() const

이 항목이 선택한 터치 포인트가 해당 항목에만 독점적으로 유지되어야 하는지 여부를 반환합니다.

setKeepTouchGrab(), keepMouseGrab(), QEvent::accept(), QEvent::ignore()도 참조하십시오 .

[virtual protected] void QQuickItem::keyPressEvent(QKeyEvent *event)

이 이벤트 핸들러는 하위 클래스에서 재구현하여 항목에 대한 키 입력 이벤트를 수신할 수 있습니다. 이벤트 정보는 ` event ` 매개변수를 통해 제공됩니다.

이벤트는 기본적으로 수락되므로, 이 함수를 재구현할 때 이벤트를 명시적으로 수락할 필요는 없습니다. 이벤트를 수락하지 않으려면 event->ignore() 를 호출하십시오.

[virtual protected] void QQuickItem::keyReleaseEvent(QKeyEvent *event)

이 이벤트 핸들러는 하위 클래스에서 재구현하여 항목에 대한 키 해제 이벤트를 수신할 수 있습니다. 이벤트 정보는 ` event ` 매개변수를 통해 제공됩니다.

이 이벤트는 기본적으로 수락되므로, 이 함수를 재구현할 때 이벤트를 명시적으로 수락할 필요는 없습니다. 이벤트를 수락하지 않으려면 event->ignore() 를 호출하십시오.

[invokable] QPointF QQuickItem::mapFromGlobal(const QPointF &point) const

전역 화면 좌표계에서 주어진 point 를 이 항목의 좌표계 내 해당 지점으로 매핑하고, 매핑된 좌표를 반환합니다.

매핑에는 항목의 다음 속성이 사용됩니다: x, y, scale, rotation, transformOrigin 및 transform.

항목들이 서로 다른 장면에 속해 있는 경우, 매핑에는 두 장면 간의 상대적 위치가 포함됩니다.

예를 들어, Qt Quick 컴포넌트에 팝업을 추가할 때 이 기능이 유용할 수 있습니다.

Qt Quick 의 ‘개념 - 시각적 좌표’항목도 참조하십시오 .

[invokable] QPointF QQuickItem::mapFromItem(const QQuickItem *item, const QPointF &point) const

item 의 좌표계에서 지정된 point 를 이 항목의 좌표계 내 해당 지점으로 매핑하고, 매핑된 좌표를 반환합니다.

매핑에는 항목의 다음 속성이 사용됩니다: x, y, scale, rotation, transformOrigin 및 transform.

항목들이 서로 다른 장면에 속하는 경우, 매핑에는 두 장면 간의 상대적 위치가 포함됩니다.

item 가 nullptr 인 경우, 이는 point 를 해당 씬의 좌표계에서 매핑합니다.

Qt Quick 의 ‘개념 - 시각 좌표’항목도 참조하십시오 .

QPointF QQuickItem::mapFromScene(const QPointF &point) const

장면의 좌표계에서 지정된 ` point `를 이 아이템의 좌표계 내 해당 지점에 매핑하고, 매핑된 좌표를 반환합니다.

매핑에는 항목의 다음 속성이 사용됩니다: x, y, scale, rotation, transformOrigin, transform.

항목들이 서로 다른 장면에 속해 있는 경우, 매핑에는 두 장면 간의 상대적 위치가 포함됩니다.

Qt Quick 의 ‘개념 - 시각적 좌표’항목도 참조하십시오 .

QRectF QQuickItem::mapRectFromItem(const QQuickItem *item, const QRectF &rect) const

item 의 좌표계에서 지정된 rect 를 이 항목의 좌표계 내 해당 직사각형 영역에 매핑하고, 매핑된 직사각형 값을 반환합니다.

매핑에는 항목의 다음 속성이 사용됩니다: x, y, scale, rotation, transformOrigin 및 transform.

항목들이 서로 다른 장면에 속해 있는 경우, 매핑에는 두 장면 간의 상대적 위치가 포함됩니다.

item 가 nullptr 인 경우, 이는 해당 장면의 좌표계에서 rect 를 매핑합니다.

Qt Quick 의 ‘개념 - 시각 좌표’항목도 참조하십시오 .

QRectF QQuickItem::mapRectFromScene(const QRectF &rect) const

장면의 좌표계에서 주어진 rect 를 이 아이템의 좌표계 내의 이에 상응하는 직사각형 영역에 매핑하고, 매핑된 직사각형 값을 반환합니다.

매핑에는 항목의 다음 속성이 사용됩니다: x, y, scale, rotation, transformOrigin 및 transform.

항목들이 서로 다른 장면에 속해 있는 경우, 매핑에는 두 장면 간의 상대적 위치가 포함됩니다.

Qt Quick 의 ‘개념 - 시각 좌표’항목도 참조하십시오 .

QRectF QQuickItem::mapRectToItem(const QQuickItem *item, const QRectF &rect) const

이 항목의 좌표계에서 주어진 rect 를 item 의 좌표계 내 해당 직사각형 영역에 매핑하고, 매핑된 직사각형 값을 반환합니다.

매핑에는 항목의 다음 속성이 사용됩니다: x, y, scale, rotation, transformOrigin 및 transform.

항목들이 서로 다른 장면에 속해 있는 경우, 매핑에는 두 장면 간의 상대적 위치 정보가 포함됩니다.

item 가 nullptr 인 경우, 이는 rect 를 해당 장면의 좌표계로 매핑합니다.

Qt Quick 의 ‘개념 - 시각 좌표’항목도 참조하십시오 .

QRectF QQuickItem::mapRectToScene(const QRectF &rect) const

이 항목의 좌표계에서 주어진 ‘ rect ’를 씬의 좌표계 내의 이에 상응하는 직사각형 영역에 매핑하고, 매핑된 직사각형 값을 반환합니다.

매핑에는 항목의 다음 속성이 사용됩니다: x, y, scale, rotation, transformOrigin 및 transform.

항목들이 서로 다른 장면에 속해 있는 경우, 매핑에는 두 장면 간의 상대적 위치가 포함됩니다.

Qt Quick 의 ‘개념 - 시각적 좌표’항목도 참조하십시오 .

[invokable] QPointF QQuickItem::mapToGlobal(const QPointF &point) const

이 항목의 좌표계에서 주어진 point 를 전역 화면 좌표계 내의 해당 점에 매핑하고, 매핑된 좌표를 반환합니다.

매핑에는 항목의 다음 속성이 사용됩니다: x, y, scale, rotation, transformOrigin 및 transform.

항목들이 서로 다른 장면에 속해 있는 경우, 매핑에는 두 장면 간의 상대적 위치가 포함됩니다.

예를 들어, Qt Quick 컴포넌트에 팝업을 추가할 때 이 정보가 유용할 수 있습니다.

Qt Quick 의 ‘개념 - 시각적 좌표’항목도 참조하십시오 .

[invokable] QPointF QQuickItem::mapToItem(const QQuickItem *item, const QPointF &point) const

이 항목의 좌표계에서 주어진 point 를 item 의 좌표계 내 해당 지점으로 매핑하고, 매핑된 좌표를 반환합니다.

매핑에는 항목의 다음 속성이 사용됩니다: x, y, scale, rotation, transformOrigin 및 transform.

항목들이 서로 다른 장면에 속해 있는 경우, 매핑에는 두 장면 간의 상대적 위치가 포함됩니다.

item 가 nullptr 인 경우, point 를 해당 장면의 좌표계로 매핑합니다.

Qt Quick 의 ‘개념 - 시각적 좌표’항목도 참조하십시오 .

QPointF QQuickItem::mapToScene(const QPointF &point) const

이 항목의 좌표계에서 지정된 point 를 씬의 좌표계 내의 해당 지점으로 매핑하고, 매핑된 좌표를 반환합니다.

매핑에는 항목의 다음 속성이 사용됩니다: x, y, scale, rotation, transformOrigin 및 transform.

항목들이 서로 다른 장면에 속해 있는 경우, 매핑에는 두 장면 간의 상대적 위치가 포함됩니다.

Qt Quick 의 ‘개념 - 시각적 좌표’항목도 참조하십시오 .

[virtual protected] void QQuickItem::mouseDoubleClickEvent(QMouseEvent *event)

이 이벤트 핸들러는 하위 클래스에서 재구현하여 항목에 대한 마우스 더블 클릭 이벤트를 수신할 수 있습니다. 이벤트 정보는 ` event ` 매개변수를 통해 제공됩니다.

이 이벤트는 기본적으로 수락되므로, 이 함수를 재구현할 때 이벤트를 명시적으로 수락할 필요는 없습니다. 이벤트를 수락하지 않으려면 event->ignore() 를 호출하십시오.

[virtual protected] void QQuickItem::mouseMoveEvent(QMouseEvent *event)

이 이벤트 핸들러는 하위 클래스에서 재구현하여 특정 항목에 대한 마우스 이동 이벤트를 수신할 수 있습니다. 이벤트 정보는 ` event ` 매개변수를 통해 제공됩니다.

마우스 이동 이벤트를 수신하려면, 선행하는 마우스 누름 이벤트를 수락해야 하며(예를 들어, ` mousePressEvent()`를 재정의하는 방식), ` acceptedMouseButtons()`는 해당 마우스 버튼을 반환해야 합니다.

이 이벤트는 기본적으로 수락되므로, 이 함수를 재구현할 때 이벤트를 명시적으로 수락할 필요는 없습니다. 이벤트를 수락하지 않으려면 event->ignore() 를 호출하십시오.

[virtual protected] void QQuickItem::mousePressEvent(QMouseEvent *event)

이 이벤트 핸들러는 하위 클래스에서 재구현하여 항목에 대한 마우스 클릭 이벤트를 수신할 수 있습니다. 이벤트 정보는 ` event ` 매개변수를 통해 제공됩니다.

마우스 클릭 이벤트를 수신하려면 acceptedMouseButtons() 함수가 해당 마우스 버튼을 반환해야 합니다.

이 이벤트는 기본적으로 수락되므로, 이 함수를 재구현할 때 이벤트를 명시적으로 수락할 필요는 없습니다. 이벤트를 수락하지 않으려면 event->ignore() 를 호출하십시오.

[virtual protected] void QQuickItem::mouseReleaseEvent(QMouseEvent *event)

이 이벤트 핸들러는 하위 클래스에서 재구현하여 특정 항목에 대한 마우스 릴리스 이벤트를 수신할 수 있습니다. 이벤트 정보는 ` event ` 매개변수를 통해 제공됩니다.

마우스 릴리스 이벤트를 수신하려면, 선행하는 마우스 누름 이벤트를 수락해야 하며(예를 들어, ` mousePressEvent()`를 오버라이드하여), ` acceptedMouseButtons()`는 해당 마우스 버튼을 반환해야 합니다.

이 이벤트는 기본적으로 수락되므로, 이 함수를 재구현할 때 이벤트를 명시적으로 수락할 필요는 없습니다. 이벤트를 수락하지 않으려면 event->ignore() 를 호출하십시오.

[virtual protected] void QQuickItem::mouseUngrabEvent()

이 이벤트 핸들러는 하위 클래스에서 재구현하여, 이 항목에서 마우스 해제 이벤트가 발생했을 때 알림을 받을 수 있습니다.

[invokable] QQuickItem *QQuickItem::nextItemInFocusChain(bool forward = true)

포커스 체인에서 이 항목의 바로 옆에 있는 항목을 반환합니다. forward 가 true 인 경우, 또는 해당 매개변수가 제공되지 않은 경우, 앞으로 방향의 다음 항목을 반환합니다. forward 가 false 인 경우, 뒤로 방향의 다음 항목을 반환합니다.

void QQuickItem::polish()

이 항목에 대한 폴리싱 작업을 예약합니다.

씬 그래프가 이 요청을 처리할 때, 이 항목에 대해 updatePolish()을 호출합니다.

updatePolish(), QQuickTest::qIsPolishScheduled() 및 ensurePolished()도 참조하십시오 .

[virtual protected] void QQuickItem::releaseResources()

이 함수는 항목이 ` QQuickItem::updatePaintNode()`에서 반환된 노드들에 의해 아직 관리되지 않는 그래픽 리소스를 해제해야 할 때 호출됩니다.

이는 항목이 이전에 렌더링되던 창에서 제거되기 직전에 발생합니다. 이 함수가 호출될 때 해당 항목은 반드시 window 를 가지고 있습니다.

이 함수는 GUI 스레드에서 호출되며, 렌더링 스레드의 상태(사용 중인 경우)는 알 수 없습니다. 객체는 직접 삭제해서는 안 되며, 대신 QQuickWindow::scheduleRenderJob()을 사용하여 정리 일정을 잡아야 합니다.

Graphics Resource Handling도 참조하십시오 .

QQuickItem *QQuickItem::scopedFocusItem() const

이 항목이 포커스 범위인 경우, 포커스 체인 내에서 현재 포커스가 설정된 항목을 반환합니다.

이 항목이 포커스 스코프가 아닌 경우 ` nullptr `를 반환합니다.

void QQuickItem::setAcceptHoverEvents(bool enabled)

enabled 가 true인 경우, 이 항목이 호버 이벤트를 수신하도록 설정합니다. 그렇지 않은 경우, 이 항목은 호버 이벤트를 수신하지 않습니다.

acceptHoverEvents()도 참조하십시오 .

void QQuickItem::setAcceptTouchEvents(bool enabled)

enabled 가 true인 경우, 이 항목이 터치 이벤트를 수신하도록 설정합니다. 그렇지 않은 경우, 이 항목은 터치 이벤트를 수신하지 않습니다.

acceptTouchEvents()도 참조하십시오 .

void QQuickItem::setAcceptedMouseButtons(Qt::MouseButtons buttons)

이 항목이 허용하는 마우스 버튼을 ` buttons`로 설정합니다.

acceptedMouseButtons()도 참조하십시오 .

void QQuickItem::setCursor(const QCursor &cursor)

이 항목에 대해 ‘ cursor ’ 모양을 설정합니다.

cursor() 및 unsetCursor()도 참조하십시오 .

void QQuickItem::setFiltersChildMouseEvents(bool filter)

이 항목의 자식 항목을 대상으로 하는 포인터 이벤트를 이 항목을 통해 필터링할지 여부를 설정합니다.

filter 가 true인 경우, 자식 항목에 대해 포인터 이벤트가 발생하면 childMouseEventFilter()가 호출됩니다.

filtersChildMouseEvents()도 참조하십시오 .

void QQuickItem::setFlag(QQuickItem::Flag flag, bool enabled = true)

enabled 가 true인 경우, 이 항목에 대해 지정된 ‘ flag ’을 활성화합니다. enabled 가 false인 경우, 이 플래그는 비활성화됩니다.

이 설정들은 항목에 대한 다양한 힌트를 제공합니다. 예를 들어, ` ItemClipsChildrenToShape ` 플래그는 이 항목의 모든 자식 요소가 항목 영역 내에 맞도록 잘려야 함을 나타냅니다.

void QQuickItem::setFlags(QQuickItem::Flags flags)

이 항목에 대해 지정된 ‘ flags ’ 기능을 활성화합니다.

flags() 및 setFlag()도 참조하십시오 .

void QQuickItem::setFocusPolicy(Qt::FocusPolicy policy)

이 항목의 포커스 정책을 ‘ policy ’로 설정합니다.

focusPolicy()도 참조하십시오 .

void QQuickItem::setKeepMouseGrab(bool keep)

마우스 입력을 이 항목에만 독점적으로 유지할지 여부를 설정합니다.

이는 미리 정의된 제스처가 발생한 후 마우스 상호작용을 확보하고 유지하고자 하는 항목에 유용합니다. 예를 들어, 수평 마우스 이동에 관심이 있는 항목은 임계값을 초과하면 ` keepMouseGrab `를 `true`로 설정할 수 있습니다. ` keepMouseGrab `가 `true`로 설정되면 필터링 항목은 마우스 이벤트에 반응하지 않습니다.

keep 가 false인 경우, 필터링 항목이 그랩을 가로챌 수 있습니다. 예를 들어, Flickable 는 사용자가 뷰포트를 이동하기 시작한 것을 감지하면 마우스 그랩을 가로채려고 시도할 수 있습니다.

keepMouseGrab()도 참조하십시오 .

void QQuickItem::setKeepTouchGrab(bool keep)

이 아이템이 잡은 터치 지점이 해당 아이템에만 독점적으로 유지되도록 할지 여부를 설정합니다.

이는 미리 정의된 제스처에 따라 특정 터치 포인트를 확보하고 유지하고자 하는 항목에 유용합니다. 예를 들어, 수평 방향의 터치 포인트 이동에 관심이 있는 항목은 임계값을 초과하면 setKeepTouchGrab을 true로 설정할 수 있습니다. setKeepTouchGrab이 true로 설정되면, 필터링 항목은 해당 터치 포인트에 반응하지 않습니다.

keep 가 false인 경우, 필터링 항목이 그랩을 가로챌 수 있습니다. 예를 들어, Flickable 는 사용자가 뷰포트를 이동하기 시작한 것을 감지하면 터치 포인트 그랩을 가로채려고 시도할 수 있습니다.

keepTouchGrab() 및 setKeepMouseGrab()도 참조하십시오 .

void QQuickItem::setSize(const QSizeF &size)

항목의 크기를 size 로 설정합니다. 이 메서드는 너비와 높이에 대한 기존 바인딩을 유지하므로, 바인딩이 다시 실행되도록 유발하는 변경 사항이 발생하면 설정된 값이 덮어쓰게 됩니다.

size, setWidth 및 setHeight도 참조하십시오 .

QSizeF QQuickItem::size() const

항목의 크기를 반환합니다.

setSize, width 및 height도 참조하십시오 .

void QQuickItem::stackAfter(const QQuickItem *sibling)

이 항목을 자식 목록 내에서 지정한 형제 항목 다음의 인덱스로 이동합니다. 자식 항목의 순서는 시각적 중첩 순서와 탭 포커스 이동 순서 모두에 영향을 미칩니다.

두 항목의 z 값이 모두 동일하다고 가정할 때, 이 작업으로 인해 ` sibling `가 이 항목 아래에 렌더링됩니다.

두 항목 모두 ` activeFocusOnTab `가 ` true`로 설정된 경우, 탭 포커스 순서도 변경되어 ` sibling `가 이 항목보다 먼저 포커스를 받게 됩니다.

지정된 sibling 은 이 항목의 형제 요소여야 합니다. 즉, 두 항목은 동일한 직접 상위 요소( parent)를 가져야 합니다.

Qt Quick 의 ‘개념 - 시각적 부모(Concepts - Visual Parent)’항목도 참조하십시오 .

void QQuickItem::stackBefore(const QQuickItem *sibling)

이 항목을 자식 목록 내에서 지정된 동급 항목 바로 앞의 인덱스로 이동합니다. 자식 항목의 순서는 시각적 중첩 순서와 탭 포커스 이동 순서 모두에 영향을 미칩니다.

두 항목의 z 값이 동일하다고 가정할 때, 이 작업으로 인해 ` sibling `가 이 항목 위에 렌더링됩니다.

두 항목 모두 ` activeFocusOnTab `가 ` true`로 설정된 경우, 탭 포커스 순서도 변경되어 ` sibling `가 이 항목 다음에 포커스를 받게 됩니다.

지정된 sibling 은 이 항목의 형제 노드여야 합니다. 즉, 두 항목은 동일한 직접 상위 노드( parent)를 가져야 합니다.

Qt Quick 의 ‘개념 - 시각적 부모(Concepts - Visual Parent)’항목도 참조하십시오 .

[virtual] QSGTextureProvider *QQuickItem::textureProvider() const

항목에 대한 텍스처 프로바이더를 반환합니다. 기본 구현은 ` nullptr`를 반환합니다.

이 함수는 렌더링 스레드에서만 호출할 수 있습니다.

[virtual protected] void QQuickItem::touchEvent(QTouchEvent *event)

이 이벤트 핸들러는 하위 클래스에서 재구현하여 항목에 대한 터치 이벤트를 수신할 수 있습니다. 이벤트 정보는 ` event ` 매개변수를 통해 제공됩니다.

이벤트는 기본적으로 수락되므로, 이 함수를 재구현할 때 이벤트를 명시적으로 수락할 필요는 없습니다. 이벤트를 수락하지 않으려면 event->ignore() 를 호출하십시오.

[virtual protected] void QQuickItem::touchUngrabEvent()

이 이벤트 핸들러는 하위 클래스에서 재구현하여, 이 항목에서 터치 해제 이벤트가 발생했을 때 알림을 받을 수 있습니다.

void QQuickItem::unsetCursor()

이 항목의 커서 모양을 지웁니다.

cursor() 및 setCursor()도 참조하십시오 .

[slot] void QQuickItem::update()

이 항목에 대해 updatePaintNode() 호출을 예약합니다.

해당 항목이 QQuickWindow 에 표시되어 있는 경우, QQuickItem::updatePaintNode() 호출은 항상 발생합니다.

QQuickItem::ItemHasContents 를 명시한 항목만 QQuickItem::update()를 호출할 수 있습니다.

[protected] void QQuickItem::updateInputMethod(Qt::InputMethodQueries queries = Qt::ImQueryInput)

필요한 경우 쿼리 값이 업데이트되었음을 입력 방식에 알립니다. ` queries `는 변경된 속성을 나타냅니다.

[virtual protected] QSGNode *QQuickItem::updatePaintNode(QSGNode *oldNode, QQuickItem::UpdatePaintNodeData *updatePaintNodeData)

아이템의 상태를 씬 그래프와 동기화해야 할 시점에 렌더 스레드에서 호출됩니다.

사용자가 해당 항목에 대해 ` QQuickItem::ItemHasContents ` 플래그를 설정한 경우, 이 함수는 ` QQuickItem::update()`의 결과로 호출됩니다.

이 함수는 해당 아이템에 대한 씬 그래프 하위 트리의 루트를 반환해야 합니다. 대부분의 구현에서는 이 아이템의 시각적 표현을 포함하는 단일 QSGGeometryNode 를 반환합니다. oldNode 는 이 함수가 마지막으로 호출되었을 때 반환된 노드입니다. updatePaintNodeData 는 이 QQuickItem 와 연관된 QSGTransformNode 에 대한 포인터를 제공합니다.

QSGNode *MyItem::updatePaintNode(QSGNode *node, UpdatePaintNodeData *)
{
    QSGSimpleRectNode *n = static_cast<QSGSimpleRectNode *>(node);
    if (!n) {
        n = new QSGSimpleRectNode();
        n->setColor(Qt::red);
    }
    n->setRect(boundingRect());
    return n;
}

이 함수가 실행되는 동안 메인 스레드는 차단되므로, 메인 스레드에서 QQuickItem 인스턴스 및 기타 객체의 값을 읽는 것은 안전합니다.

QSGNode::markDirty() 호출이나 노드 추가 및 제거와 같이 QQuickItem::updatePaintNode() 호출이 실제 장면 그래프 변경을 초래하지 않는 경우, 시각적 결과가 동일하므로 기본 구현에서 장면을 다시 렌더링하지 않기로 결정할 수 있습니다.

QSGMaterial, QSGGeometryNode, QSGGeometry, QSGFlatColorMaterial, QSGTextureMaterial, QSGNode::markDirty() 및 Graphics Resource Handling도 참조하십시오 .

[virtual protected] void QQuickItem::updatePolish()

이 함수는 해당 항목에 필요한 모든 레이아웃을 처리해야 합니다.

polish()가 호출되면, 씬 그래프는 이 항목에 대한 폴리시 이벤트를 스케줄링합니다. 씬 그래프가 이 항목을 렌더링할 준비가 되면, 다음 프레임을 렌더링하기 전에 updatePolish()를 호출하여 필요한 항목 레이아웃을 수행합니다.

ensurePolished()도 참조하십시오 .

QQuickItem *QQuickItem::viewportItem() const

ItemObservesViewport 플래그가 설정된 경우, ItemIsViewport 플래그가 설정된 가장 가까운 부모 항목을 반환합니다. 해당 플래그가 설정되지 않았거나 다른 뷰포트 항목이 발견되지 않은 경우, 창의 contentItem을 반환합니다.

뷰포트 항목이 없고 이 항목이 창에 표시되지 않는 경우에만 ` nullptr `를 반환합니다.

clipRect()도 참조하십시오 .

[virtual protected] void QQuickItem::wheelEvent(QWheelEvent *event)

이 이벤트 핸들러는 하위 클래스에서 재구현하여 특정 항목에 대한 휠 이벤트를 수신할 수 있습니다. 이벤트 정보는 ` event ` 매개변수를 통해 제공됩니다.

이 이벤트는 기본적으로 수락되므로, 이 함수를 재구현할 때 이벤트를 명시적으로 수락할 필요는 없습니다. 이벤트를 수락하지 않으려면 event->ignore() 를 호출하십시오.

[protected] bool QQuickItem::widthValid() const

width 속성이 명시적으로 설정되었는지 여부를 반환합니다.

QQuickWindow *QQuickItem::window() const

이 아이템이 렌더링되는 창을 반환합니다.

이 항목은 씬에 할당되기 전까지는 창을 가지지 않습니다. ` windowChanged()` 신호는 항목이 씬에 추가될 때와 씬에서 제거될 때 모두 알림을 제공합니다.

[signal] void QQuickItem::windowChanged(QQuickWindow *window)

이 신호는 아이템의 window 가 변경될 때 발생합니다.