Obsolete Members for QMouseEvent
QMouseEvent 클래스의 다음 멤버들은 더 이상 사용되지 않습니다. 이 멤버들은 기존 소스 코드가 계속 작동하도록 하기 위해 제공됩니다. 새로운 코드에서는 이 멤버들을 사용하지 않는 것을 강력히 권장합니다.
공개 함수
(deprecated in 6.4) | QMouseEvent(QEvent::Type type, const QPointF &localPos, Qt::MouseButton button, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, const QPointingDevice *device = QPointingDevice::primaryPointingDevice()) |
(deprecated in 6.0) QPoint | globalPos() const |
(deprecated in 6.0) int | globalX() const |
(deprecated in 6.0) int | globalY() const |
(deprecated in 6.0) QPointF | localPos() const |
(deprecated in 6.0) QPoint | pos() const |
(deprecated in 6.0) QPointF | screenPos() const |
(deprecated in 6.0) Qt::MouseEventSource | source() const |
(deprecated in 6.0) QPointF | windowPos() const |
(deprecated in 6.0) int | x() const |
(deprecated in 6.0) int | y() const |
멤버 함수 설명
[deprecated in 6.4] QMouseEvent::QMouseEvent(QEvent::Type type, const QPointF &localPos, Qt::MouseButton button, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, const QPointingDevice *device = QPointingDevice::primaryPointingDevice())
이 함수는 6.4 버전부터 더 이상 권장되지 않습니다. 새로운 코드에서는 이 함수를 사용하지 말 것을 강력히 권장합니다.
대신 다른 생성자를 사용하십시오(전역 위치가 필수입니다).
device 에서 발생한 마우스 이벤트 객체를 생성합니다.
type 매개변수는 QEvent::MouseButtonPress, QEvent::MouseButtonRelease, QEvent::MouseButtonDblClick 또는 QEvent::MouseMove 중 하나여야 합니다.
localPos 는 수신 위젯이나 항목에 대한 마우스 커서의 상대적 위치입니다. 창 위치는 localPos 와 동일한 값으로 설정됩니다. 이벤트를 발생시킨 button 는 Qt::MouseButton 열거형의 값으로 제공됩니다. 이벤트 type 가 MouseMove 인 경우, 이 이벤트에 해당하는 버튼은 Qt::NoButton 입니다. 이벤트 발생 시점의 마우스 및 키보드 상태는 buttons 와 modifiers 로 지정됩니다.
globalPosition()는 QCursor::pos()로 초기화되는데, 이는 적절하지 않을 수 있습니다. 전역 위치를 명시적으로 지정하려면 다른 생성자를 사용하십시오.
[deprecated in 6.0] QPoint QMouseEvent::globalPos() const
이 함수는 6.0 버전부터 더 이상 사용되지 않습니다. 새로운 코드에서는 이 함수를 사용하지 않는 것을 강력히 권장합니다.
대신 ` globalPosition()`.`toPoint()`를 사용하십시오.
이벤트 발생 시점의 마우스 커서의 전역 위치를 반환합니다. 이는 X11과 같은 비동기 창 시스템에서 중요합니다. 마우스 이벤트에 반응하여 위젯을 이동할 때마다, globalPos()의 값은 현재 포인터 위치( QCursor::pos())나 QWidget::mapToGlobal(pos())와 크게 다를 수 있습니다.
globalX() 및 globalY()도 참조하십시오 .
[deprecated in 6.0] int QMouseEvent::globalX() const
이 함수는 6.0 버전부터 더 이상 사용되지 않습니다. 새로운 코드에서는 이 함수를 사용하지 않는 것을 강력히 권장합니다.
대신 ` globalPosition()`, `x()`을 사용하십시오.
이벤트 발생 시점의 마우스 커서의 전역 x 좌표를 반환합니다.
globalY() 및 globalPos()도 참조하십시오 .
[deprecated in 6.0] int QMouseEvent::globalY() const
이 함수는 6.0 버전부터 더 이상 권장되지 않습니다. 새로운 코드에서는 이 함수를 사용하지 않는 것을 강력히 권장합니다.
대신 ` globalPosition()`, `y()`를 사용하십시오.
이벤트 발생 시점의 마우스 커서의 전역 y 좌표를 반환합니다.
globalX() 및 globalPos()도 참조하십시오 .
[deprecated in 6.0] QPointF QMouseEvent::localPos() const
이 함수는 6.0 버전부터 더 이상 권장되지 않습니다. 새로운 코드에서는 이 함수를 사용하지 않는 것을 강력히 권장합니다.
대신 ` position()`를 사용하십시오.
이벤트를 수신한 위젯이나 항목을 기준으로 마우스 커서의 위치를 QPointF 로 반환합니다.
마우스 이벤트의 결과로 위젯을 이동시키는 경우, 흔들리는 움직임을 방지하기 위해 screenPos()이 반환하는 화면 위치를 사용하십시오.
x(), y(), windowPos() 및 screenPos()도 참조하십시오 .
[deprecated in 6.0] QPoint QMouseEvent::pos() const
이 함수는 6.0 버전부터 더 이상 사용되지 않습니다. 새로운 코드에서는 이 함수를 사용하지 않는 것을 강력히 권장합니다.
대신 position()을 사용하십시오.
이벤트를 수신한 위젯을 기준으로 마우스 커서의 위치를 반환합니다.
마우스 이벤트의 결과로 위젯을 이동하는 경우, 흔들리는 움직임을 방지하기 위해 globalPos()이 반환하는 전역 위치를 사용하십시오.
x(), y(), globalPos()도 참조하십시오 .
[deprecated in 6.0] QPointF QMouseEvent::screenPos() const
이 함수는 6.0 버전부터 더 이상 사용되지 않습니다. 새로운 코드에서는 이 함수를 사용하지 않는 것을 강력히 권장합니다.
대신 ` globalPosition()`를 사용하십시오.
이벤트를 수신한 화면을 기준으로 마우스 커서의 위치를 ` QPointF` 객체로 반환합니다.
x(), y(), pos(), localPos(), windowPos()도 참조하십시오 .
[deprecated in 6.0] Qt::MouseEventSource QMouseEvent::source() const
이 함수는 6.0 버전부터 더 이상 권장되지 않습니다. 새로운 코드에서는 이 함수를 사용하지 않는 것을 강력히 권장합니다.
대신 ` pointingDevice()`를 사용하십시오.
마우스 이벤트 소스에 대한 정보를 반환합니다.
마우스 이벤트 소스는 실제 마우스 이벤트와 인공 마우스 이벤트를 구별하는 데 사용할 수 있습니다. 후자는 운영 체제나 Qt 자체에 의해 터치 이벤트에서 합성된 이벤트입니다. 이 열거형은 이벤트가 어디에서 합성되었는지를 알려주지만, 대개는 어떤 장치에서 합성되었는지를 아는 것이 더 유용하므로 대신 ` pointingDevice()`를 사용하십시오.
참고: 많은 플랫폼에서는 이러한 정보를 제공하지 않습니다. 이러한 플랫폼에서는 항상 ` Qt::MouseEventNotSynthesized `이 반환됩니다.
참고: Qt 5 기반코드에서는 source()가 실제 마우스에서 발생한 이벤트와, 일부 레거시 QQuickItem 또는 QWidget 서브클래스가 QTouchEvent 에 반응하지 않아 합성된 이벤트를 구별하기 위해 자주 사용되었습니다. 그러나 해당 이벤트가 QTouchEvent 에서 합성된 것인지, 아니면 QTabletEvent 에서 합성된 것인지 구분할 수 없었으며, 다른 정보도 손실되었습니다. pointingDevice()는 해당 이벤트가 발생한 구체적인 장치를 알려주므로, pointingDevice()->type() 또는 pointingDevice()->capabilities() 를 확인하여 이 이벤트에 어떻게 대응할지 결정할 수 있습니다. 하지만 마우스 이벤트만 처리하기보다는 원래 이벤트에 바로 대응하는 것이 더 좋습니다.
Qt::MouseEventSource 및 QGraphicsSceneMouseEvent::source()도 참조하십시오 .
[deprecated in 6.0] QPointF QMouseEvent::windowPos() const
이 함수는 6.0 버전부터 더 이상 사용되지 않습니다. 새로운 코드에서는 이 함수를 사용하지 않는 것을 강력히 권장합니다.
대신 ` scenePosition()`를 사용하십시오.
이벤트를 수신한 창을 기준으로 마우스 커서의 위치를 ` QPointF` 객체로 반환합니다.
마우스 이벤트의 결과로 위젯을 이동하는 경우, 흔들리는 움직임을 방지하기 위해 globalPos()가 반환하는 전역 위치를 사용하십시오.
x(), y(), pos(), localPos() 및 screenPos()도 참조하십시오 .
[deprecated in 6.0] int QMouseEvent::x() const
이 함수는 6.0 버전부터 더 이상 사용되지 않습니다. 새로운 코드에서는 이 함수를 사용하지 않는 것을 강력히 권장합니다.
대신 ` position().x()`를 사용하십시오.
이벤트를 수신한 위젯을 기준으로 마우스 커서의 x 좌표를 반환합니다.
[deprecated in 6.0] int QMouseEvent::y() const
이 함수는 6.0 버전부터 더 이상 사용되지 않습니다. 새로운 코드에서는 이 함수를 사용하지 않는 것을 강력히 권장합니다.
대신 ` position().y()`를 사용하십시오.
이벤트를 수신한 위젯을 기준으로 마우스 커서의 y 좌표를 반환합니다.
© 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.