QPointingDevice Class
QPointingDeviceクラスは、マウスやタッチ、タブレットのイベントが発生するデバイスを記述します。詳細...
| Header: | #include <QPointingDevice> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Since: | Qt 6.0 |
| Inherits: | QInputDevice |
- 継承メンバを含む全メンバ一覧
- QPointingDevice は、イベントクラスの一部です。
パブリック型
| enum | GrabTransition { GrabExclusive, UngrabExclusive, CancelGrabExclusive, GrabPassive, UngrabPassive, …, OverrideGrabPassive } |
| enum class | PointerType { Unknown, Generic, Finger, Pen, Eraser, …, AllPointerTypes } |
| flags | PointerTypes |
パブリック関数
| QPointingDevice(QObject *parent = nullptr) | |
| QPointingDevice(const QString &name, qint64 id, QInputDevice::DeviceType deviceType, QPointingDevice::PointerType pointerType, QInputDevice::Capabilities capabilities, int maxPoints, int buttonCount, const QString &seatName = QString(), QPointingDeviceUniqueId uniqueId = QPointingDeviceUniqueId(), QObject *parent = nullptr) | |
| int | buttonCount() const |
| int | maximumPoints() const |
| QPointingDevice::PointerType | pointerType() const |
| QPointingDeviceUniqueId | uniqueId() const |
シグナル
| void | grabChanged(QObject *grabber, QPointingDevice::GrabTransition transition, const QPointerEvent *event, const QEventPoint &point) const |
静的パブリック・メンバー
| const QPointingDevice * | primaryPointingDevice(const QString &seatName = QString()) |
詳細説明
各QPointerEvent は、タイプや能力のようなデバイス固有のプロパティにアクセスできるように、QPointingDevice ポインタを含んでいます。ポインタ・イベントを生成する前に、QWindowSystemInterfaceを介して利用可能なポインティング・デバイスを登録するのは、プラットフォームまたはジェネリック・プラグインの責任です。アプリケーションはこのクラスをインスタンス化する必要はなく、QPointerEvent::device()が指すグローバルインスタンスにアクセスするだけでよい。
メンバ型ドキュメント
enum QPointingDevice::GrabTransition
この列挙型は、あるオブジェクト（おそらくnullptr ）から別のオブジェクト（おそらくnullptr ）への排他的または受動的なグラブの遷移を表す。QPointingDevice::grabChanged() シグナルの引数として発行される。
有効な値は
| 定数 | 値 | 説明 |
|---|---|---|
QPointingDevice::GrabExclusive | 0x10 | QPointerEvent::setExclusiveGrabber() の後に発せられる。 |
QPointingDevice::UngrabExclusive | 0x20 | グラバがnullptr に設定されているとき、QPointerEvent::setExclusiveGrabber() の後に発せられ、グラブが正常に終了したことを通知する。 |
QPointingDevice::CancelGrabExclusive | 0x30 | QPointerEvent::setExclusiveGrabber() の後に、グラバが別のオブジェクトに設定された場合に発せられ、古いグラバのグラバが「盗まれた」ことを通知する。 |
QPointingDevice::GrabPassive | 0x01 | QPointerEvent::addPassiveGrabber() の後に発せられる。 |
QPointingDevice::UngrabPassive | 0x02 | QPointerEvent::removePassiveGrabber() の後など、パッシブグラブが正常に終了したときに発せられる。 |
QPointingDevice::CancelGrabPassive | 0x03 | パッシブグラブが異常終了した時（ジェスチャーがキャンセルされた時）に発せられる。 |
QPointingDevice::OverrideGrabPassive | 0x04 | この値は現在使用されていません。 |
enum class QPointingDevice::PointerType
flags QPointingDevice::PointerTypes
この列挙型は、ポインティングデバイスと相互作用するものを表します。
このプロパティとQInputDevice::DeviceType の間には冗長性があります。例えば、タッチスクリーンを使用する場合、DeviceType はTouchScreen で、PointerType はFinger です（常に）。しかし、グラフィック・タブレットでは、スタイラスの両端が使用されることがよくあり、プログラムはそれらを区別する必要があります。そのため、この概念を拡張して、すべてのQPointerEvent に PointerType を持たせ、DeviceType を無視して PointerType だけで異なる反応をするようにすると、イベント処理コードを簡略化できます。
有効な値は以下の通りです：
| 定数 | 値 | 説明 |
|---|---|---|
QPointingDevice::PointerType::Unknown | 0 | ポインタタイプが不明。 |
QPointingDevice::PointerType::Generic | 0x0001 | マウスまたはマウスのように動作するもの（X11のコアポインタ）。 |
QPointingDevice::PointerType::Finger | 0x0002 | ユーザの指。 |
QPointingDevice::PointerType::Pen | 0x0004 | スタイラスの描画端。 |
QPointingDevice::PointerType::Eraser | 0x0008 | スタイラスのもう一方の端(もう一方の端に仮想消しゴムがある場合)。 |
QPointingDevice::PointerType::Cursor | 0x0010 | Puck デバイスにあるような、十字線を持つ透明な円。 |
QPointingDevice::PointerType::AllPointerTypes | 0x7FFF | 上記のいずれか（デフォルトのフィルタ値として使用）。 |
PointerTypes型はQFlags<PointerType>のtypedefである。PointerType値のORの組み合わせを格納する。
メンバー関数ドキュメント
QPointingDevice::QPointingDevice(QObject *parent = nullptr)
parent の子として新しい無効なポインティングデバイスのインスタンスを作成します。
QPointingDevice::QPointingDevice(const QString &name, qint64 id, QInputDevice::DeviceType deviceType, QPointingDevice::PointerType pointerType, QInputDevice::Capabilities capabilities, int maxPoints, int buttonCount, const QString &seatName = QString(), QPointingDeviceUniqueId uniqueId = QPointingDeviceUniqueId(), QObject *parent = nullptr)
与えられたname,deviceType,pointerType,capabilities,maxPoints,buttonCount,seatName,uniqueId,parent を持つ新しいポインティングデバイスインスタンスを作成します。
int QPointingDevice::buttonCount() const
検出可能なデバイス上のボタンの最大数を返します。
注： プロパティ buttonCount のゲッター関数。
[signal] void QPointingDevice::grabChanged(QObject *grabber, QPointingDevice::GrabTransition transition, const QPointerEvent *event, const QEventPoint &point) const
このシグナルは、event の配信中に、grabber オブジェクトがpoint の排他的または受動的なグラブを得たり失ったりしたときに発せられます。transition は、grabber オブジェクトの視点から、何が起こったかを伝えます。
注： あるオブジェクトから別のオブジェクトへのグラブ遷移は、あるオブジェクトがグラブを失ったことを通知するシグナルと、別のグラブがあることを通知するシグナルの2つが発生します。grabber 引数がnullptr になることはありません。
QPointerEvent::setExclusiveGrabber(),QPointerEvent::addPassiveGrabber(),QPointerEvent::removePassiveGrabber()も参照のこと 。
int QPointingDevice::maximumPoints() const
検出可能な同時タッチポイント（指）の最大数を返します。
注： プロパティ maximumPoints のゲッター関数です。
QPointingDevice::PointerType QPointingDevice::pointerType() const
ポインタ型： ポインタ型を返す。
注： プロパティ pointerType のゲッター関数。
[static] const QPointingDevice *QPointingDevice::primaryPointingDevice(const QString &seatName = QString())
指定された座席seatName のプライマリポインティングデバイス（コアポインタ、従来はマウスと仮定）を返します。
複数のポインティングデバイスが登録されている場合、この関数は、指定されたseatName に一致し、他のデバイスを親として持たないマウスまたはタッチパッドを優先します。通常、親デバイスを持たないマスターデバイスまたはコアデバイスは1つだけです。しかし、そのようなデバイスが見つからない場合、この関数は新しい仮想「コアポインタ」マウスを作成します。こうして Qt は、まだ入力デバイスの発見と登録を行っていないプラットフォームでも動作し続けることができます。
QPointingDeviceUniqueId QPointingDevice::uniqueId() const
デバイスの一意なID（実用性は疑わしい）を返します。
むしろQPointerEventPoint::uniqueId()の方を気にする必要があるでしょう。
注: プロパティ uniqueId のゲッター関数です。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
