Obsolete Members for MouseEvent

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

プロパティ

• source : int (deprecated in 6.2)

物件に関する資料

source : int [read-only, deprecated in 6.2]

このプロパティは、QtQuick 6.2 以降、非推奨となっています。新しいコードでの使用は強くお勧めしません。

acceptedDevices を設定した入力ハンドラを使用してください。

このプロパティは、マウスイベントのソースを保持します。

マウスイベントのソースは、本物のマウスイベントと人工的なマウスイベントを区別するために使用できます。タッチスクリーンやグラフィックタブレットなどの他のポインティングデバイスを使用する場合、アプリケーションが実際のタッチイベントやタブレットイベントを利用していないと、マウスイベントはオペレーティングシステムまたはQt自体によって合成されることがあります。

値は以下のいずれかになります。

• Qt.MouseEventNotSynthesized - 最も一般的な値。この情報が利用可能なプラットフォームでは、この値は、そのイベントがシステムからの本物のマウスイベントであることを示します。
• Qt.MouseEventSynthesizedBySystem - マウスイベントがプラットフォームによってタッチイベントまたはタブレットイベントから合成されたことを示します。
• Qt.MouseEventSynthesizedByQt - マウスイベントが、Qt によって未処理のタッチまたはタブレットイベントから合成されたことを示します。
• Qt.MouseEventSynthesizedByApplication - マウスイベントがアプリケーションによって合成されたことを示します。これにより、アプリケーションが生成したマウスイベントと、システムから送信されたイベントや Qt によって合成されたイベントとを区別することができます。

たとえば、実際のマウスからのイベントにのみ反応させるには：

MouseArea {
    onPressed: (mouse)=> {
        if (mouse.source !== Qt.MouseEventNotSynthesized)
            mouse.accepted = false
    }

    onClicked: doSomething()
}

押下イベントのハンドラがイベントを拒否した場合、そのイベントはさらに下流へ伝播され、その下にある別のItemがタッチスクリーンからの合成イベントを処理できるようになります。 例えば、下層で Flickable が使用されている場合（かつ、MouseArea が Flickable の子ではない場合）、MouseArea が本物のマウスイベントをある方法で処理しつつ、タッチイベントは下層の Flickable に透過させることで、タッチスクリーンでのフリック操作機能を維持するのに役立ちます。 その場合、マウスによる Flickable のドラッグ機能は失われますが、Flickable がマウスホイールイベントを受信することを妨げることはありません。