QPointerEvent Class
포인터 이벤트의 기본 클래스입니다. 더 보기...
| 헤더: | #include <QPointerEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| 다음부터: | Qt 6.0 |
| 상속받음: | QInputEvent |
| 상속받은 버전: |
공개 함수
| bool | addPassiveGrabber(const QEventPoint &point, QObject *grabber) |
| bool | allPointsAccepted() const |
| bool | allPointsGrabbed() const |
| void | clearPassiveGrabbers(const QEventPoint &point) |
| QObject * | exclusiveGrabber(const QEventPoint &point) const |
| QList<QPointer<QObject>> | passiveGrabbers(const QEventPoint &point) const |
| QEventPoint & | point(qsizetype i) |
| QEventPoint * | pointById(int id) |
| qsizetype | pointCount() const |
| QPointingDevice::PointerType | pointerType() const |
| const QPointingDevice * | pointingDevice() const |
| const QList<QEventPoint> & | points() const |
| bool | removePassiveGrabber(const QEventPoint &point, QObject *grabber) |
| void | setExclusiveGrabber(const QEventPoint &point, QObject *exclusiveGrabber) |
재구현된 공용 함수
| virtual void | setAccepted(bool accepted) override |
보호된 함수
| QPointerEvent(QPointerEvent &&) | |
| QPointerEvent & | operator=(QPointerEvent &&) |
| QPointerEvent & | operator=(const QPointerEvent &other) |
멤버 함수 문서
[protected delete] QPointerEvent::QPointerEvent(QPointerEvent &&)
QPointerEvent 의 인스턴스를 move-construct로 생성합니다. 이 함수는 삭제되었습니다.
bool QPointerEvent::addPassiveGrabber(const QEventPoint &point, QObject *grabber)
지정된 grabber 가 향후 모든 업데이트 이벤트와, 지정된 point 를 포함하는 릴리스 이벤트를 수신하도록 전달 로직에 알립니다. 이 이벤트들이 다른 곳에 전달될지 여부와는 무관합니다.
이 기능은 Qt Quick 입력 핸들러에서만 사용됩니다.
grabber 가 이미 추가된 경우 false 를 반환하고, 그렇지 않은 경우 true 를 반환합니다.
bool QPointerEvent::allPointsAccepted() const
points()의 모든 점에 대해 isPointAccepted()가 true 인 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.
bool QPointerEvent::allPointsGrabbed() const
points()에 포함된 모든 점이 exclusiveGrabber()를 하나 이상 갖거나, 하나 이상의 passiveGrabbers()를 갖는 경우 true 를 반환합니다.
void QPointerEvent::clearPassiveGrabbers(const QEventPoint &point)
지정된 point 에서 모든 수동 그라버를 제거합니다.
이 함수는 Qt Quick 입력 핸들러에서만 사용할 수 있습니다.
QPointerEvent::addPassiveGrabber()도 참조하십시오 .
QObject *QPointerEvent::exclusiveGrabber(const QEventPoint &point) const
지정된 ` point`를 포함하는 향후 모든 업데이트 이벤트와 릴리스 이벤트를 수신하도록 설정된 객체를 반환합니다.
현재로서는 주로 Qt Quick 에서 사용하기 위한 것입니다.
setExclusiveGrabber()도 참조하십시오 .
QList<QPointer<QObject>> QPointerEvent::passiveGrabbers(const QEventPoint &point) const
지정된 point 를 포함하는 향후 모든 업데이트 이벤트 및 릴리스 이벤트를 수신하도록 요청된 객체 목록을 반환합니다.
이 함수는 Qt Quick 입력 핸들러에서만 사용할 수 있습니다.
QPointerEvent::addPassiveGrabber()도 참조하십시오 .
QEventPoint &QPointerEvent::point(qsizetype i)
인덱스 i 에 있는 점에 대한 ` QEventPoint ` 참조를 반환합니다.
QEventPoint *QPointerEvent::pointById(int id)
id 가 주어진 id 와 일치하는 점을 반환하며, 해당 점이 없는 경우에는 nullptr 를 반환합니다.
qsizetype QPointerEvent::pointCount() const
이 포인터 이벤트에 포함된 포인트의 개수를 반환합니다.
QPointingDevice::PointerType QPointerEvent::pointerType() const
이벤트를 발생시킨 포인트의 유형을 반환합니다.
const QPointingDevice *QPointerEvent::pointingDevice() const
이 이벤트가 발생한 소스 장치를 반환합니다.
이는 ` QInputEvent::device()`와 동일하지만, 편의상 형 변환이 적용된 것입니다.
const QList<QEventPoint> &QPointerEvent::points() const
이 포인터 이벤트에 포함된 점들의 목록을 반환합니다.
bool QPointerEvent::removePassiveGrabber(const QEventPoint &point, QObject *grabber)
지정된 point 에 이전에 추가된 수동형 grabber 를 제거합니다. 이전에 수동형 그라버였던 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.
이 함수는 Qt Quick 입력 핸들러에서만 사용해야 합니다.
QPointerEvent::addPassiveGrabber()도 참조하십시오 .
[override virtual] void QPointerEvent::setAccepted(bool accepted)
void QPointerEvent::setExclusiveGrabber(const QEventPoint &point, QObject *exclusiveGrabber)
지정된 exclusiveGrabber 가 향후 모든 업데이트 이벤트와 지정된 point 를 포함하는 릴리스 이벤트를 수신해야 하며, 다른 항목에 대한 전달은 건너뛸 수 있음을 전달 로직에 알립니다.
현재로서는 주로 Qt Quick 에서 사용됩니다.
exclusiveGrabber()도 참조하십시오 .
[protected delete] QPointerEvent &QPointerEvent::operator=(QPointerEvent &&)
other 를 이 QPointerEvent 인스턴스에 이동 할당합니다. 이 함수는 삭제됩니다.
[noexcept protected default] QPointerEvent &QPointerEvent::operator=(const QPointerEvent &other)
other 를 이 QPointerEvent 인스턴스에 복사-할당합니다.
© 2026 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.