QEventPoint Class

속성 문서

accepted : bool

이 속성은 이벤트 포인트의 수락 상태를 저장합니다.

위젯 기반 애플리케이션에서는 이 속성이 사용되지 않습니다. 위젯이 전체 QInputEvent 를 수락하거나 거부하는 경우에만 의미가 있기 때문입니다.

그러나 제스처 이벤트( Qt Quick )에서는, 아이템(Item)이나 이벤트 핸들러(Event Handler)가 제스처 이벤트 그룹( QTouchEvent ) 내에서 실제로 제스처에 참여하는 개별 포인트만 수락하고, 다른 포인트는 다른 아이템이나 핸들러로 전달되는 것이 일반적입니다. 일관성을 위해, 이는 모든 제스처 이벤트 그룹( QPointerEvent)에 적용되며, 전달은 제스처 이벤트 그룹( QPointerEvent )의 모든 포인트가 수락된 경우에만 이루어집니다.

액세스 함수:

QEvent::accepted도 참조하십시오 .

[read-only] device : const QPointingDevice*

이 속성은 이 이벤트 포인트의 출처가 되는 포인팅 장치를 나타냅니다.

액세스 함수:

[read-only] ellipseDiameters : const QSizeF

이 속성은 터치 지점을 둘러싼 타원의 너비와 높이를 저장합니다.

반환 값은 논리 픽셀 단위입니다. 대부분의 터치스크린은 접촉 지점의 모양을 감지하지 못하며, 마우스나 태블릿 기기 역시 이를 감지할 수 없으므로, 크기가 null인 경우가 가장 일반적입니다. 일부 터치스크린에서는 직경이 0이 아니며 항상 동일할 수 있습니다(타원이 원으로 근사 처리됨).

액세스 함수:

[read-only] globalGrabPosition : const QPointF

이 속성은 이 점이 잡힌 전역 위치를 저장합니다.

전역 위치는 화면 또는 가상 데스크톱을 기준으로 합니다.

액세스 함수:

globalPosition, grabPosition 및 sceneGrabPosition도 참조하십시오 .

[read-only] globalLastPosition : const QPointF

이 속성은 이전 클릭 또는 이동 이벤트 시 이 점의 전역 위치를 저장합니다.

전역 위치는 화면 또는 가상 데스크톱을 기준으로 합니다.

액세스 함수:

globalPosition, lastPosition 및 sceneLastPosition도 참조하십시오 .

[read-only] globalPosition : const QPointF

이 속성은 이 점의 전역 위치를 저장합니다.

전역 위치는 화면 또는 가상 데스크톱을 기준으로 합니다.

관련 함수:

globalPressPosition, position, scenePosition도 참조하십시오 .

[read-only] globalPressPosition : const QPointF

이 속성은 이 점이 눌렸던 전역 위치를 저장합니다.

전역 위치는 화면 또는 가상 데스크톱을 기준으로 합니다.

관련 함수:

globalPosition, pressPosition, scenePressPosition도 참조하십시오 .

[read-only] grabPosition : const QPointF

이 속성은 이 점이 잡힌 위치를 저장합니다.

이 위치는 이벤트를 수신한 위젯 또는 항목을 기준으로 합니다.

액세스 함수:

position도 참조하십시오 .

[read-only] id : const int

이 속성은 해당 이벤트 포인트의 ID 번호를 저장합니다.

액세스 함수:

[read-only] lastPosition : const QPointF

이 속성은 이전 클릭 또는 이동 이벤트 당시 이 점의 위치를 저장합니다.

이 위치는 이벤트를 수신한 위젯이나 항목을 기준으로 합니다.

액세스 함수:

position 및 pressPosition도 참조하십시오 .

[read-only] lastTimestamp : const ulong

이 속성은 이 점을 포함했던 이전 QPointerEvent 의 시간을 저장합니다.

액세스 함수:

globalLastPosition도 참조하십시오 .

[read-only] position : const QPointF

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

이 위치는 이벤트를 수신한 위젯 또는 항목을 기준으로 합니다.

액세스 함수:

[read-only] pressPosition : const QPointF

이 속성은 이 점이 눌렸던 위치를 저장합니다.

이 위치는 이벤트를 수신한 위젯이나 항목을 기준으로 합니다.

액세스 함수:

position도 참조하십시오 .

[read-only] pressTimestamp : const ulong

이 속성은 해당 점이 눌렸던 가장 최근의 시간을 저장합니다.

액세스 함수:

timestamp도 참조하십시오 .

[read-only] pressure : const qreal

이 속성은 해당 지점의 압력을 나타냅니다.

반환 값의 범위는 0.0 에서 1.0 사이입니다.

액세스 함수:

[read-only] rotation : const qreal

이 속성은 해당 지점의 각도 방향을 저장합니다.

반환 값은 도(°) 단위이며, 0(기본값)은 손가락, 토큰 또는 스타일러스가 위쪽을 가리키고 있음을 나타내고, 음의 각도는 왼쪽으로 회전되었음을, 양의 각도는 오른쪽으로 회전되었음을 의미합니다. 대부분의 터치스크린은 회전을 감지하지 않으므로 0이 가장 일반적인 값입니다.

액세스 함수:

[read-only] sceneGrabPosition : const QPointF

이 속성은 이 점이 캡처된 장면 위치를 저장합니다.

이 장면 위치는 QQuickItem::event()에서 처리되는 경우 QQuickWindow 를 기준으로 한 위치이며, QGraphicsItem::touchEvent()의 오버라이드에서 처리되는 경우 QGraphicsScene 좌표계상의 위치이고, 위젯 애플리케이션에서는 창 내의 위치입니다.

액세스 함수:

scenePosition, grabPosition 및 globalGrabPosition도 참조하십시오 .

[read-only] sceneLastPosition : const QPointF

이 속성은 이전 클릭 또는 이동 이벤트 당시 이 지점의 씬 위치를 저장합니다.

씬 위치는 ` QQuickItem::event()`에서 처리되는 경우 ` QQuickWindow `을 기준으로 한 상대적 위치이며, `QGraphicsItem::touchEvent()`를 재정의하여 처리되는 경우 ` QGraphicsScene ` 좌표계에서의 위치, 위젯 애플리케이션에서는 창 내의 위치입니다.

액세스 함수:

scenePosition 및 scenePressPosition도 참조하십시오 .

[read-only] scenePosition : const QPointF

이 속성은 이 점의 장면 위치를 저장합니다.

씬 위치는 QQuickItem::event()에서 처리될 경우 QQuickWindow 를 기준으로 한 상대적 위치이며, QGraphicsItem::touchEvent()의 오버라이드로 처리될 경우 QGraphicsScene 좌표계를 기준으로 한 상대적 위치이며, 위젯 애플리케이션에서는 창 내의 위치를 의미합니다.

액세스 함수:

scenePressPosition, position 및 globalPosition도 참조하십시오 .

[read-only] scenePressPosition : const QPointF

이 속성은 해당 지점이 누른 시점의 장면 위치를 저장합니다.

씬 위치는 QQuickItem::event()에서 처리되는 경우 QQuickWindow 를 기준으로 한 상대적 위치이며, QGraphicsItem::touchEvent()를 재정의하여 처리되는 경우 QGraphicsScene 좌표계에서의 위치, 위젯 애플리케이션에서는 창 내의 위치입니다.

액세스 함수:

scenePosition, pressPosition 및 globalPressPosition도 참조하십시오 .

[read-only] state : const State

이 속성은 이벤트 포인트의 현재 상태를 저장합니다.

액세스 함수:

[read-only] timeHeld : const qreal

이 속성은 이 점이 눌린 후 놓이지 않은 상태인 시간(초 단위)을 저장합니다.

액세스 함수:

pressTimestamp 및 timestamp도 참조하십시오 .

[read-only] timestamp : const ulong

이 속성은 해당 지점이 ‘ QPointerEvent ’에 포함된 가장 최근의 시간을 나타냅니다.

액세스 함수:

참조: QPointerEvent::timestamp()

[read-only] uniqueId : const QPointingDeviceUniqueId

이 속성은 해당 점 또는 토큰(있는 경우)의 고유 ID를 저장합니다.

터치스크린은 손가락을 고유하게 식별할 수 없기 때문에 이 속성은 종종 유효하지 않습니다( isValid() 참조).

QTabletEvent 에서 반환된 값인 경우, 사용 중인 스타일러스의 일련 번호를 식별합니다.

TUIO 드라이버가 이를 지원하는 터치스크린과 함께 사용될 때, 특정 토큰(기준 물체)을 식별할 수도 있습니다.

액세스 함수:

[read-only] velocity : const QVector2D

이 속성은 화면 또는 데스크톱의 좌표계에서 초당 픽셀 단위의 속도 벡터를 저장합니다.

액세스 함수:

QInputDevice::capabilities() 및 QInputEvent::device()도 참조하십시오 .