handlerPoint QML Type

이벤트 포인트. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• device : PointerDevice
• ellipseDiameters : size
• id : int
• modifiers : enumeration
• position : point
• pressPosition : point
• pressedButtons : enumeration
• pressure : real
• rotation : real
• sceneGrabPosition : point
• scenePosition : point
• scenePressPosition : point
• uniqueId : pointingDeviceUniqueId
• velocity : vector2d

상세 설명

QEventPoint 의 핸들러 소유 QML 표현.

핸들러의 현재 ` point ` 또는 ` centroid`의 속성에 바인딩을 설정할 수 있습니다. 예를 들어:

import QtQuick

Item {
    width: 640
    height: 480

    DragHandler {
        id: handler
        target: null
    }

    Text {
        color: handler.active ? "darkgreen" : "black"
        text: handler.centroid.position.x.toFixed(1) + "," + handler.centroid.position.y.toFixed(1)
        x: handler.centroid.position.x - width / 2
        y: handler.centroid.position.y - height
    }
}

DragHandler 가 eventPoint 에 적극적으로 반응하고 있을 때는 point가 최신 상태로 유지되지만, point가 해제된 후나 현재 point가 다른 핸들러에 의해 처리되고 있을 때는 position.x 와 position.y 가 0이 됩니다.

SinglePointHandler::point 및 MultiPointHandler::centroid도 참조하십시오 .

속성 문서

device : PointerDevice [read-only]

이 속성은 해당 점(및 해당 이벤트)이 발생한 장치를 저장합니다.

ellipseDiameters : size [read-only]

이 속성은 이벤트가 터치포인트에서 발생하고 기기가 해당 정보를 제공하는 경우, 접촉 영역의 직경을 저장합니다.

터치포인트는 손가락이 터치스크린에 닿아 압력을 가하는 타원형 영역으로 모델링됩니다. (사실 비트맵으로 모델링될 수도 있지만, 그 경우 이벤트가 전송되기 전에 접촉 영역에 타원형 경계 추정치가 적용될 것으로 예상됩니다.) 사용자가 더 세게 누를수록 접촉 영역은 더 커지므로, 기기에 별도의 압력 센서가 없는 경우 이 직경 값을 통해 압력을 감지하는 또 다른 방법을 제공할 수 있습니다. 타원의 중심은 scenePosition ( PointerHandler 의 'Item' 로컬 좌표계에서position )에 위치합니다. rotation 속성은 알려진 경우 타원의 회전 각도를 제공합니다. rotation 가 0인 경우, 표면을 향해 위쪽이나 바깥쪽으로 뻗는 일반적인 손 위치 때문에 height 가 더 큰 치수(장축)가 될 것으로 예상됩니다.

접촉 영역이 알려지지 않았거나 기기가 터치스크린이 아닌 경우, 이 값들은 0이 됩니다.

QtQuick::TouchPoint::ellipseDiameters 및 QEventPoint::ellipseDiameters도 참조하십시오 .

id : int [read-only]

점의 ID 번호

터치 제스처가 진행되는 동안, 첫 번째 손가락이 눌린 시점부터 마지막 손가락이 떼어질 때까지 각 터치 포인트에는 고유한 ID 번호가 할당됩니다. 마찬가지로, 여러 장치에서 입력이 발생하는 경우(예: 마우스와 터치 입력의 동시 발생), 모든 장치에서 현재 생성된 모든 터치 포인트( eventPoints )에는 고유한 ID가 할당됩니다.

QEventPoint::id도 참조하십시오 .

modifiers : enumeration [read-only]

현재 어떤 수정 키가 눌려 있는지

이 속성은 이벤트가 발생했을 당시 눌려 있던 키보드 수정 키를 저장합니다.

position : point [read-only]

parent 항목 내의 위치

이것은 parent 의 경계와 비교한 eventPoint 의 위치입니다.

pressPosition : point [read-only]

parent 항목 내의 누른 위치

이 위치는 parent 의 경계에 대한 상대적 위치로, 이 점이 눌렸던 위치를 나타냅니다.

pressedButtons : enumeration [read-only]

현재 어떤 마우스 또는 스타일러스 버튼이 눌려 있는지

MouseArea::pressedButtons도 참조하십시오 .

pressure : real [read-only]

이 속성은 사용자가 그래픽 태블릿에서 스타일러스를 누르는 힘이나 터치스크린에서 손가락으로 누르는 힘의 강도를 나타내며, 범위는 0 (측정 가능한 압력 없음)부터 1.0 (장치가 측정할 수 있는 최대 압력)까지입니다.

이 속성은 압력을 측정할 수 있는 특정 태블릿 및 터치스크린에서만 유효합니다. 그렇지 않은 경우 값은 0이 됩니다.

rotation : real [read-only]

이 속성은 그래픽 태블릿에서 스타일러스의 회전 각도나 터치스크린에서 터치 지점의 접촉 영역을 나타냅니다.

이 속성은 회전 각도를 측정할 수 있는 특정 태블릿 스타일러스 장치 및 터치스크린에서만 유효합니다. 그렇지 않은 경우 값은 0이 됩니다.

sceneGrabPosition : point [read-only]

씬 내의 잡힌 위치

이 지점이 포인터 핸들러나 아이템에 의해 잡혀 있는 경우, 해당 오브젝트가 이 지점의 이동 및 해제를 전적으로 담당하고 있음을 의미합니다. 이 경우, 이 위치는 장면 그래프의 좌표계에서 잡힘이 발생한 지점입니다.

scenePosition : point [read-only]

장면 내 위치

이는 eventPoint 의 위치가 Qt Quick 장면의 경계(일반적으로 전체 창)를 기준으로 한 상대적 위치입니다.

scenePressPosition : point [read-only]

씬 내에서의 누름 위치

이것은 씬 그래프의 좌표계에서 이 점이 눌렸던 위치입니다.

uniqueId : pointingDeviceUniqueId [read-only]

해당 지점의 고유 ID (있는 경우)

터치스크린은 손가락을 고유하게 식별할 수 없기 때문에, 이 필드는 일반적으로 비어 있습니다.

일부 터치스크린, 특히 TUIO 드라이버를 사용하는 터치스크린의 경우, 손가락 외에도 식별 가능한 물리적 토큰(기준 물체)을 사용할 수 있습니다. 따라서 이 점이 터치 지점이고 uniqueId가 설정되어 있다면, 이는 해당 물체의 식별자입니다.

그래픽 태블릿의 경우, 각 유형의 스타일러스나 기타 도구에는 대개 고유 ID나 일련번호가 있으며, 이는 도구마다 다른 방식으로 반응하는 데 유용할 수 있습니다.

이 ID의 내용을 해석하려면 사용 중인 하드웨어와 드라이버에 대한 지식이 필요합니다.

QTabletEvent::uniqueId 및 QtQuick::TouchPoint::uniqueId도 참조하십시오 .

velocity : vector2d [read-only]

평균 속도와 이동 방향을 나타내는 벡터

이 벡터는 이동 방향을 가리키는 속도 벡터로, 단위는 논리적 픽셀/초입니다. 이 벡터는 x 및 y 성분을 가지며, 이 점이 이동 중일 때는 이 중 적어도 하나는 0이 아닙니다. 이 벡터는 최근의 평균 속도, 즉 eventPoint 가 최근에 얼마나 빠르게, 어떤 방향으로 이동해 왔는지를 나타냅니다.

QtQuick::TouchPoint::velocity 및 QEventPoint::velocity항목도 참조하십시오 .