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 の値として与えられる。イベント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 位置を返します。
[deprecated in 6.0]
int QMouseEvent::globalY() const
この関数は6.0以降非推奨です。新しいコードでは使用しないことを強くお勧めします。
代わりにglobalPosition().y() を使用してください。
イベント発生時のマウス・カーソルのグローバルな y 位置を返します。
[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() が返すグローバル位置を使用して、揺れを回避してください。
[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 ベースのコードでは、レガシーのQQuickItem やQWidget のサブクラスがQTouchEvent に反応しないため、実際のマウスからのマウスイベントと合成されたマウスイベントを区別するために source() がよく使われていました。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 位置を返します。
©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。