このページでは

PointerDevice QML Type

QPointingDevice のQML相当。詳細...

Import Statement: import QtQuick
In C++: QPointingDevice

プロパティ

信号

  • grabChanged(QtObject grabber, enumeration transition, PointerEvent event, eventPoint point)

詳細な説明

PointerDevice は、QPointingDevice クラスの QML 名です。QPointingDevice と同じプロパティと列挙型を持っています。

プロパティのドキュメント

buttonCount : int [read-only]

このプロパティは、デバイス上で検出可能なボタンの最大数を示します。

deviceType : enumeration

このプロパティは、PointerEvent を生成したデバイスの種類を示します。

有効な値は以下の通りです:

定数説明
PointerDevice.Unknownデバイスを特定できません。
PointerDevice.Mouseマウス。
PointerDevice.TouchScreenタッチスクリーン。
PointerDevice.TouchPadタッチパッドまたはトラックパッド。
PointerDevice.Stylusグラフィックタブレット上のスタイラス。
PointerDevice.Airbrushグラフィックタブレットのエアブラシ。
PointerDevice.Puckグラフィックタブレット上の十字線付きデジタイザー。

「 QInputDevice::DeviceType 」および「PointerDeviceHandler::acceptedDevices 」も参照してください 。

maximumPoints : int [read-only]

このプロパティは、検出可能な同時タッチポイント(指)の最大数を指定します。

pointerType : enumeration [read-only]

このプロパティは、PointerDevice と相互作用している対象を示します。

このプロパティとdeviceType の間には、ある程度の冗長性があります。たとえば、タッチスクリーンを使用する場合、deviceType はTouchScreen となり、pointerType はFinger となります。しかし、グラフィックスタブレットでは、スタイラスの両端が使用されることが多く、プログラムはそれらを区別する必要があります。PointerDeviceHandler::acceptedDevices とPointerDeviceHandler::acceptedPointerTypes を組み合わせて使用することで、特定のハンドラが反応すべきイベントのサブセットをフィルタリングすることができます。

有効な値は以下の通りです:

定数説明
PointerDevice.Unknownデバイスを識別できません。
PointerDevice.Genericマウス、またはマウスをエミュレートするデバイス。
PointerDevice.Fingerタッチスクリーン上の指。
PointerDevice.Penグラフィックタブレット上のスタイラス。
PointerDevice.Eraserグラフィックタブレットの消しゴム。
PointerDevice.Cursorグラフィックスタブレット上の、十字線付きのデジタイザー。

「 QPointingDevice::PointerType 」および「PointerDeviceHandler::acceptedPointerTypes 」も参照してください 。

uniqueId : pointingDeviceUniqueId [read-only]

このプロパティは、利用可能な場合、デバイスに固有のIDを提供することがあります。たとえば、グラフィックタブレットのスタイラスデバイスには、固有のシリアル番号が割り当てられている場合があります。

関連項目: eventPoint およびQEventPoint::uniqueId()。

Signal ドキュメント

grabChanged(QtObject grabber, enumeration transition, PointerEvent event, eventPoint point)

このシグナルは、event の配信中に、grabber オブジェクトがpoint の排他的またはパッシブなグラブを取得または解放した際に発火します。transition は、grabber オブジェクト(Item またはInput Handlerのいずれか)の観点から、何が発生したかを示します。

transition の有効な値は以下の通りです:

定数説明
PointerDevice.GrabExclusivegrabber は、point の処理について主たる責任を引き受けました。
PointerDevice.UngrabExclusivegrabber は、以前の排他的なグラブを解放しました。
PointerDevice.CancelGrabExclusivegrabber の排他的なグラブが引き継がれたか、または解除されました。
PointerDevice.GrabPassivegrabber は、point を監視するためのパッシブグラブを獲得しました。
PointerDevice.UngrabPassivegrabber は、以前のパッシブグラブを解除しました。
PointerDevice.CancelGrabPassive以前のパッシブグラブが異常終了しました。

注: あるオブジェクトから別のオブジェクトへのグラブ遷移では 、1つのオブジェクトがグラブを失ったことを通知する信号と、別のグラバーが存在することを通知する信号の2つの信号が発生します。それ以外の場合、グラブ状態への遷移または非グラブ状態からの遷移では、1つの信号のみが発行されます。

注: 対応するハンドラは onGrabChanged です。

QPointerEvent::setExclusiveGrabber()、QPointerEvent::addPassiveGrabber()、QPointerEvent::removePassiveGrabber()、およびPointerHandler::grabChanged()も参照してください 。

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