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 enum の値として与えられる。イベントtypeMouseMove の場合、このイベントに適切なボタンはQt::NoButton です。イベント発生時のマウスとキーボードの状態は、buttonsmodifiers で指定される。

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 が返されます。

QTouchEvent QTabletEvent注意: Qt 5 ベースのコードでは、レガシーのQQuickItemQWidget のサブクラスがQTouchEvent に反応しないため、実際のマウスからのマウスイベントと合成されたマウスイベントを区別するために source() がよく使われていました。pointingDevice() を見れば、そのイベントが発生した特定のデバイスがわかるので、pointingDevice()->type()pointingDevice()->capabilities() をチェックして、このイベントにどう反応するかを決めることができる。しかし、マウス・イベントだけを処理するよりも、元のイベントに反応した方がもっと良い。

Qt::MouseEventSourceQGraphicsSceneMouseEvent::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 位置を返します。

y() およびpos()も参照して ください。

[deprecated in 6.0] int QMouseEvent::y() const

この関数は6.0から非推奨となった。新しいコードでは使用しないことを強くお勧めします。

代わりにposition().y() を使用してください。

イベントを受け取ったウィジェットからの相対的なマウスカーソルの y 位置を返します。

x() およびpos()も参照して ください。

© 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.