Obsolete Members for QQuickItem

QQuickItem クラスの以下のメンバーは非推奨となっています。これらは、古いソースコードが動作し続けるように提供されているものです。新しいコードでの使用は強く推奨しません。

パブリック関数

(deprecated) void grabMouse()
(deprecated) void grabTouchPoints(const QList<int> &ids)
(deprecated) void ungrabMouse()
(deprecated) void ungrabTouchPoints()

メンバー関数のドキュメント

[deprecated] void QQuickItem::grabMouse()

この関数は非推奨です。新しいコードでの使用は強くお勧めしません。

代わりに `QPointerEvent::setExclusiveGrabber()` を使用してください。

マウス入力を取得します。

このアイテムは、ungrabMouse() が呼び出されるまで、すべてのマウスイベントを受信します。通常、この関数は呼び出すべきではありません。例えば、マウスクリックイベントを受け入れることで、その後のイベントが確実にそのアイテムに配信されるようになるためです。あるアイテムが、現在の受信者からマウスイベントを引き継ぎたい場合は、この関数を呼び出す必要があります。

警告:この関数の使用には 注意が必要です。

[deprecated] void QQuickItem::grabTouchPoints(const QList<int> &ids)

この関数は非推奨です。新しいコードでの使用は強く推奨しません。

QPointerEvent::setExclusiveGrabber() を使用してください。ids で指定されたタッチポイントを取得します。

これらのタッチポイントは、解放されるまでそのアイテムが所有します。ただし、Flickable のようなフィルタリングアイテムによって、このグラブが奪われる可能性があります。グラブが奪われるのを防ぐには、setKeepTouchGrab() を使用してください。

[deprecated] void QQuickItem::ungrabMouse()

この関数は非推奨となっています。新しいコードでの使用は強くお勧めしません。

QPointerEvent::setExclusiveGrabber() を使用してください。

grabMouse() の呼び出し後に、マウスのグラブを解除します。

なお、この関数は、アイテムがそれ以降のイベント処理を停止したい場合にのみ呼び出す必要があります。リリースイベントやキャンセルイベントの発生後は、いずれにせよ今後のイベントは受信されないため、この関数を呼び出す必要はありません。この関数が呼び出された後は、移動イベントやリリースイベントは配信されません。

[deprecated] void QQuickItem::ungrabTouchPoints()

この関数は非推奨です。新しいコードでの使用は強くお勧めしません。

代わりに QEventPoint::setExclusiveGrabber() を使用してください。このアイテムが所有するタッチポイントの独占状態を解除します。

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