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() を使用してください。

マウス・イベント・ソースに関する情報を返します。

マウス・イベント・ソースは、本物のマウス・イベントと人工的なマウス・イベントを区別するために使用することができます。後者は、OS や 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()も参照して ください。

©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。