Back to Qt.io
Contact Us Blog Download Qt

QGestureEvent Class

QGestureEvent クラスは、トリガーされたジェスチャーの説明を提供します。詳細...

Header: #include <QGestureEvent>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Inherits: QEvent

パブリック関数

QGestureEvent(const QList<QGesture *> &gestures)
virtual ~QGestureEvent()
void accept(QGesture *gesture)
void accept(Qt::GestureType gestureType)
QList<QGesture *> activeGestures() const
QList<QGesture *> canceledGestures() const
QGesture *gesture(Qt::GestureType type) const
QList<QGesture *> gestures() const
void ignore(QGesture *gesture)
void ignore(Qt::GestureType gestureType)
bool isAccepted(QGesture *gesture) const
bool isAccepted(Qt::GestureType gestureType) const
QPointF mapToGraphicsScene(const QPointF &gesturePoint) const
void setAccepted(QGesture *gesture, bool value)
void setAccepted(Qt::GestureType gestureType, bool value)
QWidget *widget() const

詳細説明

QGestureEvent クラスには、gestures() 関数を使用して取得できるジェスチャーのリストが含まれています。

ジェスチャーは、アクティブまたはキャンセルされます。現在実行されているジェスチャーのリストは、activeGestures() 関数を使用して取得できます。canceledGestures （）関数を使用すると、以前にアクティブでキャンセルされたジェスチャーのリストにアクセスできます。ジェスチャがキャンセルされるのは、たとえば、現在のウィンドウのフォーカスが失われた場合、タイムアウトが発生した場合、またはその他の理由です。

イベント・ハンドラが一般的なQEvent::accept() 関数を呼び出すことによってイベントを受け入れない場合、Qt::GestureStarted 状態で受け入れない個々のQGesture オブジェクトはすべて、ウィジェットがそれぞれQGestureEvent::accept() を呼び出すことによってそれらを個別に受け入れるか、イベント・フィルタがイベントを消費するまで、親ウィジェット・チェーンに伝搬されます。

参考文献

Qt におけるジェスチャ処理の概要と、アプリケーションでジェスチャを使用するための情報については、「Gestures in Widgets and Graphics View」を参照してください。

QGesture 、QGestureRecognizer 、QWidget::grabGesture()、QGraphicsObject::grabGesture()も参照して ください。

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

[explicit] QGestureEvent::QGestureEvent(const QList<QGesture *> &gestures)

gestures のリストを含む新しい QGestureEvent を作成します。

[virtual noexcept] QGestureEvent::~QGestureEvent()

QGestureEvent を破棄します。

void QGestureEvent::accept(QGesture *gesture)

与えられたgesture オブジェクトのacceptフラグを設定します。これはsetAccepted(gesture, true)を呼び出すことと同じです。

acceptフラグを設定することは、イベント受信者がジェスチャを望んでいることを示します。不要なジェスチャは、親ウィジェットに伝搬される可能性があります。

QGestureEvent::ignore()も参照してください 。

void QGestureEvent::accept(Qt::GestureType gestureType)

gestureType setAccepted(gestureType, true) を呼び出すのと同じです。

accept フラグの設定は、イベント受信者がそのジェスチャを望んでいることを示します。不要なジェスチャは、親ウィジェットに伝搬される場合があります。

QGestureEvent::ignore()も参照してください 。

QList<QGesture *> QGestureEvent::activeGestures() const

アクティブな（キャンセルされていない）ジェスチャのリストを返します。

QList<QGesture *> QGestureEvent::canceledGestures() const

キャンセルされたジェスチャのリストを返します。

QGesture *QGestureEvent::gesture(Qt::GestureType type) const

type によってジェスチャ・オブジェクトを返します。

QList<QGesture *> QGestureEvent::gestures() const

イベントで配信されたすべてのジェスチャを返します。

void QGestureEvent::ignore(QGesture *gesture)

与えられたgesture オブジェクトの accept フラグ・パラメータをクリアします。これはsetAccepted(gesture, false) を呼び出すことと同じです。

acceptフラグをクリアすることは、イベント受信者がそのジェスチャを望んでいないことを示します。不要なジェスチャは親ウィジェットに伝搬される可能性があります。

QGestureEvent::accept()も参照してください 。

void QGestureEvent::ignore(Qt::GestureType gestureType)

gestureType setAccepted(gesture, false) を呼び出すのと同じです。

accept フラグをクリアすることは、イベント受信者がそのジェスチャを望んでいないことを示します。不要なジェスチャは親ウィジェットに伝搬される可能性があります。

QGestureEvent::accept()も参照してください 。

bool QGestureEvent::isAccepted(QGesture *gesture) const

gesture が受け入れられた場合はtrue を返し、そうでない場合はfalse を返します。

bool QGestureEvent::isAccepted(Qt::GestureType gestureType) const

gestureType タイプのジェスチャが受け入れられた場合はtrue を返し、そうでない場合はfalse を返します。

QPointF QGestureEvent::mapToGraphicsScene(const QPointF &gesturePoint) const

gesturePoint がグラフィックビュー内にある場合、シーンローカル座標を返します。

この関数は、ジェスチャ・イベントがQGraphicsObject に配信され、スクリーン座標の点をシーンローカル座標に変換するときに便利です。

QPointF::isNull()も参照 。

void QGestureEvent::setAccepted(QGesture *gesture, bool value)

与えられたgesture オブジェクトのアクセプトフラグを、指定されたvalue に設定する。

アクセプトフラグの設定は、イベント受信者がgesture を望んでいることを示します。

デフォルトでは、QEvent::Gesture タイプのイベントのジェスチャは受け入れられ、QEvent::GestureOverride イベントのジェスチャは無視されます。

便宜上、accept(gesture) で accept フラグを設定し、ignore(gesture) でクリアすることもできます。

isAccepted()も参照 。

void QGestureEvent::setAccepted(Qt::GestureType gestureType, bool value)

与えられたgestureType オブジェクトのアクセプト・フラグを、指定されたvalue に設定する。

acceptフラグの設定は、イベント受信者が指定されたタイプのジェスチャーの受信を望んでいることを示しますgestureType 。不要なジェスチャは親ウィジェットに伝搬される可能性があります。

デフォルトでは、QEvent::Gesture タイプのイベントのジェスチャは受け入れられ、QEvent::GestureOverride イベントのジェスチャは無視されます。

便宜上、accept(gestureType) で accept フラグを設定し、ignore(gestureType) でクリアすることもできます。

QWidget *QGestureEvent::widget() const

イベントが発生したウィジェットを返します。

©2024 The Qt Company Ltd. 本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。