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 기반 코드에서 일부 레거시 QQuickItem 또는 QWidget 서브클래스가 QTouchEvent 에 반응하지 않아서 실제 마우스 이벤트와 합성된 마우스 이벤트를 구분하기 위해 source()를 사용하는 경우가 종종 있었습니다. 하지만 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 위치를 반환합니다.
© 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.