Back to Qt.io
Contact Us Blog Download Qt

handlerPoint QML Type

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

Import Statement: import QtQuick

속성

상세 설명

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 에 활발하게 응답하고 있을 때는 포인트가 최신 상태로 유지되지만, 포인트가 해제된 후 또는 현재 포인트가 다른 처리기에 의해 처리되고 있을 때는 position.x 및 position.y 이 0이 됩니다.

참고: eventPoint 과 실질적으로 동일하지만 eventPoint 은 수명이 긴 Q_GADGET 의 단기 복사본으로, 제스처 간에 무효화되고 후속 이벤트 전달에 재사용됩니다. 해당 속성에 대한 지속적인 바인딩은 불가능하며, 개별 핸들러는 해당 지점이 해당 핸들러가 처리 중인 활성 제스처의 일부인 기간 외에는 해당 지점에 의존할 수 없습니다. 핸들러 포인트는 핸들러가 소유하는 Q_GADGET 입니다. 이를 통해 해당 프로퍼티에 평생 바인딩할 수 있습니다.

SinglePointHandler::point 및 MultiPointHandler::centroid 을참조하세요 .

속성 문서

device : PointerDevice [read-only]

이 프로퍼티는 포인트(및 해당 이벤트)가 발생한 디바이스를 보유합니다.


ellipseDiameters : size [read-only]

이벤트가 터치포인트에서 발생하고 디바이스가 이 정보를 제공하는 경우 이 속성은 접점 패치의 직경을 보유합니다.

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

접촉 패치를 알 수 없거나 장치가 터치스크린이 아닌 경우 이 값은 0이 됩니다.

QtQuick::TouchPoint::ellipseDiameters 및 QEventPoint::ellipseDiameters 을참조하세요 .


id : int [read-only]

포인트의 ID 번호

터치 제스처 중에 첫 번째 손가락을 누른 시점부터 마지막 손가락을 놓을 때까지 각 터치포인트에는 고유한 ID 번호가 있습니다. 마찬가지로 여러 디바이스에서 입력이 발생하는 경우(예: 마우스와 터치를 동시에 누르는 경우) 모든 디바이스의 현재 eventPoints 에는 고유한 ID가 있습니다.

참고: ID 번호가 0부터 시작하거나 순차적이라고 가정하지 마세요. 기본 드라이버의 작동 방식 때문에 이러한 가정은 잘못된 경우가 많습니다.

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]

씬 내 위치

Qt Quick 씬의 경계(일반적으로 전체 창)를 기준으로 한 eventPoint 의 위치입니다.


scenePressPosition : point [read-only]

장면 내에서 눌린 위치

장면 그래프의 좌표계에서 이 점을 눌렀던 위치입니다.


uniqueId : pointingDeviceUniqueId [read-only]

포인트의 고유 ID(있는 경우)

터치스크린은 손가락을 고유하게 식별할 수 없으므로 일반적으로 비어 있습니다.

일부 유형의 터치스크린, 특히 TUIO 드라이버를 사용하는 터치스크린에서는 손가락 외에도 인식 가능한 물리적 토큰(신뢰 객체)을 사용할 수 있습니다. 따라서 이 지점이 터치 포인트이고 고유아이디가 설정되어 있으면 해당 개체의 식별자가 됩니다.

그래픽 태블릿에서는 각 유형의 스타일러스 또는 기타 도구마다 고유 ID 또는 일련 번호가 있는 경우가 많으므로 도구마다 다른 방식으로 응답하는 데 유용할 수 있습니다.

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

QTabletEvent::uniqueId 및 QtQuick::TouchPoint::uniqueId 을참조하세요 .


velocity : vector2d [read-only]

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

이동 방향을 가리키는 속도 벡터로, 초당 논리적 픽셀 단위로 표시됩니다. 이 벡터에는 x와 y 성분이 있으며, 이 중 적어도 하나는 이 점이 움직일 때 0이 아닙니다. 여기에는 최근 평균 속도, 즉 eventPoint 이 최근 어느 방향으로 얼마나 빠르게 움직였는지가 포함됩니다.

QtQuick::TouchPoint::velocity 및 QEventPoint::velocity 을참조하세요 .


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