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 座標を返します。
© 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.