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 은 항상 부모 체인의 모든 자식 마우스이벤트필터에 전송됩니다.

setFiltersChildMouseEvents()도 참조하세요 .

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

다시 구현합니다: QQmlParserStatus::classBegin().

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

[virtual] QRectF QQuickItem::clipRect() const

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

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

중첩된 뷰포트 항목의 경우 clipRect()는 ItemIsViewport 플래그가 설정된 모든 조상 항목의 boundingRects의 교차점으로, 이 항목의 좌표계에 매핑됩니다.

boundingRect()도 참조하십시오 .

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

다시 구현합니다: QQmlParserStatus::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)

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

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

이벤트는 기본적으로 수락되므로 이 기능을 다시 구현하는 경우 이벤트를 명시적으로 수락할 필요는 없습니다. 이벤트를 수락하지 않으려면 event->ignore() 으로 문의하세요.

Drag 및 드래그 앤 드롭도 참조하세요 .

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

이 이벤트 핸들러는 하위 클래스에서 다시 구현하여 항목에 대한 드래그-아웃 이벤트를 수신할 수 있습니다. 이벤트 정보는 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에 도입되었습니다.

디버깅 기법 및 감마레이의 Qt Quick 인스펙터도참조하십시오 .

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

updatePolish()를 호출합니다.

이는 폴란드 이벤트를 수신할 때까지 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)

이 이벤트 핸들러는 하위 클래스에서 다시 구현하여 항목에 대한 포커스인 이벤트를 수신할 수 있습니다. 이벤트 정보는 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 을 사용하여 대상 이미지의 크기를 지정합니다. 기본적으로 결과는 항목과 같은 크기입니다.

그랩을 시작할 수 없는 경우 이 함수는 null 을 반환합니다.

QQuickWindow::grabWindow()도 참조하세요 .

[protected] bool QQuickItem::heightValid() const

높이 프로퍼티가 명시적으로 설정되었는지 여부를 반환합니다.

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

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

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

이벤트는 기본적으로 수락되므로 이 함수를 다시 구현하는 경우 이벤트를 명시적으로 수락할 필요는 없습니다. 이벤트를 수락하지 않으려면 event->ignore() 으로 전화하세요.

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

이 이벤트 핸들러는 하위 클래스에서 다시 구현하여 항목에 대한 마우스오버-탈퇴 이벤트를 수신할 수 있습니다. 이벤트 정보는 event 매개변수에 의해 제공됩니다.

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

이벤트는 기본적으로 수락되므로 이 함수를 다시 구현하는 경우 이벤트를 명시적으로 수락할 필요는 없습니다. 이벤트를 수락하지 않으려면 event->ignore() 으로 전화하세요.

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

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

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

이벤트는 기본적으로 수락되므로 이 함수를 다시 구현하는 경우 이벤트를 명시적으로 수락할 필요는 없습니다. 이벤트를 수락하지 않으려면 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 컴포넌트의 구성이 완료되면 참을 반환하고, 그렇지 않으면 거짓을 반환합니다.

구성 요소가 완료될 때까지 일부 처리를 지연시키는 것이 바람직한 경우가 많습니다.

componentComplete()도 참조하세요 .

bool QQuickItem::isFocusScope() const

이 항목이 포커스 범위인 경우 참을 반환하고 그렇지 않으면 거짓을 반환합니다.

[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 이 참이면 항목이 마우스오버 이벤트를 허용하도록 설정하고, 그렇지 않으면 이 항목에서 마우스오버 이벤트를 허용하지 않습니다.

acceptHoverEvents()도 참조하세요 .

void QQuickItem::setAcceptTouchEvents(bool enabled)

enabled 이 참이면 항목이 터치 이벤트를 허용하도록 설정하고, 그렇지 않으면 이 항목에서 터치 이벤트를 허용하지 않습니다.

acceptTouchEvents()도 참조하세요 .

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

이 항목이 수락하는 마우스 버튼을 buttons 로 설정합니다.

acceptedMouseButtons()도 참조하세요 .

void QQuickItem::setCursor(const QCursor &cursor)

이 항목의 cursor 모양을 설정합니다.

cursor() 및 unsetCursor()도 참조하세요 .

void QQuickItem::setFiltersChildMouseEvents(bool filter)

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

filter 이 참이면 하위 항목에 대한 포인터 이벤트가 트리거될 때 childMouseEventFilter()가 호출됩니다.

filtersChildMouseEvents()도 참조하세요 .

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

enabled 이 참이면 이 항목에 대해 지정된 flag 을 활성화하고 enabled 이 거짓이면 플래그가 비활성화됩니다.

예를 들어 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 이 참으로 설정되면 필터링 항목은 마우스 이벤트에 반응하지 않습니다.

keep 이 거짓인 경우 필터링 항목이 그랩을 훔칠 수 있습니다. 예를 들어 Flickable 은 사용자가 뷰포트를 움직이기 시작한 것을 감지하면 마우스 그랩을 훔치려고 시도할 수 있습니다.

keepMouseGrab()도 참조하세요 .

void QQuickItem::setKeepTouchGrab(bool keep)

이 항목에 잡힌 터치 포인트를 이 항목에만 유지할지 여부를 설정합니다.

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

keep 이 거짓인 경우 필터링 항목이 그랩을 훔칠 수 있습니다. 예를 들어 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)

지정된 sibling 항목을 하위 목록에서 이 항목 뒤의 인덱스로 이동합니다. 하위 항목의 순서는 시각적 스택 순서와 탭 포커스 탐색 순서 모두에 영향을 줍니다.

두 항목의 z 값이 동일하다고 가정하면 sibling 이 이 항목 아래에 렌더링됩니다.

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

지정된 sibling 은 이 항목의 형제 항목이어야 합니다. 즉, 동일한 바로 아래 parent 을 가져야 합니다.

Qt Quick 의 개념 - 시각적 부모를참조하세요 .

void QQuickItem::stackBefore(const QQuickItem *sibling)

지정된 sibling 항목을 하위 목록에서 이 항목 앞의 색인으로 이동합니다. 하위 항목의 순서는 시각적 스택 순서와 탭 포커스 탐색 순서 모두에 영향을 줍니다.

두 항목의 z 값이 동일하다고 가정하면 sibling 이 이 항목 위에 렌더링됩니다.

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

지정된 sibling 은 이 항목의 형제 항목이어야 합니다. 즉, 동일한 바로 아래 parent 을 가져야 합니다.

Qt Quick 의 개념 - 시각적 부모를참조하세요 .

[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()로의 호출을 예약합니다.

QQuickItem::updatePaintNode() 호출은 항목이 QQuickWindow 에 표시되는 경우 항상 수행됩니다.

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() 또는 노드 추가 및 제거와 같은 실제 씬 그래프 변경이 발생하지 않는 경우, 기본 구현은 시각적 결과가 동일하므로 씬을 다시 렌더링하지 않기로 결정할 수 있습니다.

QSGMaterial, QSGGeometryNode, QSGGeometry, QSGFlatColorMaterial, QSGTextureMaterial, QSGNode::markDirty() 및 Graphics Resource Handling 을참조하세요 .

[virtual protected] void QQuickItem::updatePolish()

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

polish()가 호출되면 씬 그래프는 이 항목에 대한 폴리시 이벤트를 예약합니다. 씬 그래프가 이 항목을 렌더링할 준비가 되면 업데이트폴리시()를 호출하여 다음 프레임을 렌더링하기 전에 필요에 따라 모든 항목 레이아웃을 수행합니다.

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

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

QQuickWindow *QQuickItem::window() const

이 항목이 렌더링되는 창을 반환합니다.

항목은 씬에 할당될 때까지 창이 없습니다. windowChanged () 신호는 항목이 씬에 입력될 때와 씬에서 제거될 때 모두 알림을 제공합니다.

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

이 신호는 항목의 window 이 변경될 때 전송됩니다.