QHoverEvent Class
QHoverEvent 클래스에는 마우스 이벤트를 설명하는 매개변수들이 포함되어 있습니다. 더 보기...
| 헤더: | #include <QHoverEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| 상속: | QSinglePointEvent |
- 상속된 멤버를 포함한 모든 멤버 목록
- 사용 중단된 멤버
- QHoverEvent는 이벤트 클래스의 일부입니다.
공개 함수
| QHoverEvent(QEvent::Type type, const QPointF &scenePos, const QPointF &globalPos, const QPointF &oldPos, Qt::KeyboardModifiers modifiers = Qt::NoModifier, const QPointingDevice *device = QPointingDevice::primaryPointingDevice()) | |
| QPoint | oldPos() const |
| QPointF | oldPosF() const |
보호된 함수
| QHoverEvent(QHoverEvent &&) | |
| QHoverEvent & | operator=(QHoverEvent &&) |
| QHoverEvent & | operator=(const QHoverEvent &other) |
상세 설명
마우스 이벤트는 마우스 커서가 위젯 안으로 들어오거나, 밖으로 나가거나, 위젯 내에서 이동할 때, 그리고 위젯에 Qt::WA_Hover 속성이 설정되어 있는 경우에 발생합니다.
position() 함수는 현재 커서 위치를 반환하는 반면, oldPos() 함수는 이전 마우스 위치를 반환합니다.
QEvent::HoverEnter 및 QEvent::HoverLeave 이벤트와 QEvent::Enter 및 QEvent::Leave 이벤트 간에는 몇 가지 유사점이 있습니다. 그러나 HoverEnter 및 HoverLeave의 이벤트 핸들러에서 update()를 수행하기 때문에 이 두 이벤트는 와 약간 다릅니다.
QEvent::HoverMove 또한 QEvent::MouseMove 와도 약간 다릅니다. 최상위 창 A에 자식 창 B가 있고, 그 안에 또 다른 자식 창 C가 포함된 경우(모두 마우스 추적 기능이 활성화된 상태)를 생각해 봅시다:
이제 A의 중앙에서 커서를 위에서 아래로 이동하면 다음과 같은 QEvent::MouseMove 이벤트가 발생합니다:
- A::MouseMove
- B::MouseMove
- C::MouseMove
QEvent::HoverMove 의 경우에도 동일한 이벤트가 발생하지만, 이벤트가 수락되었는지 여부와 관계없이 이벤트는 항상 최상위 레벨로 전파된다는 점이 다릅니다. 이벤트 전파는 Qt::WA_NoMousePropagation 속성이 설정된 경우에만 중단됩니다.
이 경우 이벤트는 다음과 같은 방식으로 발생합니다:
- A::HoverMove
- A::HoverMove, B::HoverMove
- A::HoverMove, B::HoverMove, C::HoverMove
멤버 함수 문서
QHoverEvent::QHoverEvent(QEvent::Type type, const QPointF &scenePos, const QPointF &globalPos, const QPointF &oldPos, Qt::KeyboardModifiers modifiers = Qt::NoModifier, const QPointingDevice *device = QPointingDevice::primaryPointingDevice())
device 에서 비롯된 호버 이벤트 객체를 생성합니다.
type 매개변수는 QEvent::HoverEnter, QEvent::HoverLeave 또는 QEvent::HoverMove 중 하나여야 합니다.
scenePos 는 수신 창이나 씬을 기준으로 한 현재 마우스 커서의 위치이며, oldPos 는 그 이전의 위치이고, globalPos 는 절대 좌표계에서 마우스의 위치입니다. modifiers 는 이벤트 발생 시점의 모든 키보드 수정키 상태를 저장합니다.
[protected delete] QHoverEvent::QHoverEvent(QHoverEvent &&)
QHoverEvent 의 인스턴스를 move-construct로 생성합니다. 이 함수는 삭제되었습니다.
QPoint QHoverEvent::oldPos() const
이벤트를 수신한 위젯을 기준으로 마우스 커서의 이전 위치를 반환합니다. 이전 위치가 없는 경우, oldPos()는 position()와 동일한 위치를 반환합니다.
QEvent::HoverEnter 이벤트 발생 시, 이 위치는 항상 QPoint(-1, -1)이 됩니다.
position()도 참조하십시오 .
QPointF QHoverEvent::oldPosF() const
이벤트를 수신한 위젯을 기준으로 마우스 커서의 이전 위치를 반환합니다. 이전 위치가 없는 경우, oldPosF()는 position()와 동일한 위치를 반환합니다.
QEvent::HoverEnter 이벤트 발생 시, 이 위치는 항상 QPointF(-1, -1)이 됩니다.
position()도 참조하십시오 .
[protected delete] QHoverEvent &QHoverEvent::operator=(QHoverEvent &&)
other 를 이 QHoverEvent 인스턴스에 할당합니다. 이 함수는 삭제됩니다.
[noexcept protected default] QHoverEvent &QHoverEvent::operator=(const QHoverEvent &other)
other 을 이 QHoverEvent 인스턴스에 복사-할당합니다.
© 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.
