Qt Quick/Declarativeでスワイプジェスチャーの方向を判定する

Qt WidgetsにおけるQSwipeGesture::SwipeDirection enum解説

定義

enum QSwipeGesture::SwipeDirection {
  Left,
  Right,
  Up,
  Down
};

それぞれの値

• Left: 左方向へのスワイプ
• Right: 右方向へのスワイプ
• Up: 上方向へのスワイプ
• Down: 下方向へのスワイプ

使用例

// スワイプジェスチャーオブジェクトを作成
QSwipeGesture *swipeGesture = new QSwipeGesture(this);

// 特定の方向へのスワイプを検知
swipeGesture->setSwipeDirection(QSwipeGesture::Right);

// スワイプジェスチャー発生時の処理
QObject::connect(swipeGesture, &QSwipeGesture::swiped, [this](QSwipeGesture *gesture) {
  if (gesture->swipeDirection() == QSwipeGesture::Right) {
    // 右方向へのスワイプ処理
  }
});

補足

• QSwipeGestureクラスには、setSwipeThreshold()やsetCancelPolicy()など、スワイプジェスチャーの動作を調整するための様々なプロパティがあります。
• Qt Widgets以外にも、Qt QuickやQt Declarativeなど、Qtの他のフレームワークでもQSwipeGesture::SwipeDirection enumを使用できます。

QSwipeGesture::SwipeDirection enumを使用したサンプルコード

方向によって処理を変える

QSwipeGesture *swipeGesture = new QSwipeGesture(this);

swipeGesture->setSwipeDirection(QSwipeGesture::Right);

QObject::connect(swipeGesture, &QSwipeGesture::swiped, [this](QSwipeGesture *gesture) {
  if (gesture->swipeDirection() == QSwipeGesture::Right) {
    // 右方向へのスワイプ処理
    qDebug() << "右方向へスワイプされました";
  } else if (gesture->swipeDirection() == QSwipeGesture::Left) {
    // 左方向へのスワイプ処理
    qDebug() << "左方向へスワイプされました";
  } else if (gesture->swipeDirection() == QSwipeGesture::Up) {
    // 上方向へのスワイプ処理
    qDebug() << "上方向へスワイプされました";
  } else if (gesture->swipeDirection() == QSwipeGesture::Down) {
    // 下方向へのスワイプ処理
    qDebug() << "下方向へスワイプされました";
  }
});

スワイプ距離による処理の違い

QSwipeGesture *swipeGesture = new QSwipeGesture(this);

swipeGesture->setSwipeDistance(100); // 最低100px以上のスワイプのみ検知

QObject::connect(swipeGesture, &QSwipeGesture::swiped, [this](QSwipeGesture *gesture) {
  if (gesture->swipeDirection() == QSwipeGesture::Right) {
    if (gesture->swipeLength() > 200) {
      // 長距離右スワイプ処理
      qDebug() << "長距離右方向へスワイプされました";
    } else {
      // 短距離右スワイプ処理
      qDebug() << "短距離右方向へスワイプされました";
    }
  }
});

QMLでの使用例

import QtQuick 2.15

Item {
  width: 640
  height: 480

  Rectangle {
    id: rect
    width: 200
    height: 200
    color: "red"

    // スワイプジェスチャー設定
    SwipeGesture {
      onSwiped: {
        if (swipeDirection === Qt.Left) {
          rect.x -= 100
        } else if (swipeDirection === Qt.Right) {
          rect.x += 100
        } else if (swipeDirection === Qt.Up) {
          rect.y -= 100
        } else if (swipeDirection === Qt.Down) {
          rect.y += 100
        }
      }
    }
  }
}

QSwipeGesture::SwipeDirection enum以外の方法

QMouseEvent::pos()

void mouseMoveEvent(QMouseEvent *event) {
  // 前回のマウス座標
  static QPoint previousPos;

  // スワイプの方向判定
  if (event->buttons() & Qt::LeftButton) {
    QPoint delta = event->pos() - previousPos;
    if (delta.x() > 0) {
      // 右方向へスワイプ
    } else if (delta.x() < 0) {
      // 左方向へスワイプ
    }
    if (delta.y() > 0) {
      // 下方向へスワイプ
    } else if (delta.y() < 0) {
      // 上方向へスワイプ
    }
  }

  previousPos = event->pos();
}

QTouchGesture

QTouchGesture *gesture = new QTouchGesture(this);

gesture->setGestureType(Qt::TapAndHoldGesture);

QObject::connect(gesture, &QTouchGesture::touchEvent, [this](QTouchEvent *event) {
  if (event->type() == QEvent::TouchBegin) {
    // タッチ開始
  } else if (event->type() == QEvent::TouchUpdate) {
    // タッチ移動
    QPointF delta = event->touchPoints()[0].pos() - event->touchPoints()[0].startPos();
    if (delta.x() > 0) {
      // 右方向へスワイプ
    } else if (delta.x() < 0) {
      // 左方向へスワイプ
    }
    if (delta.y() > 0) {
      // 下方向へスワイプ
    } else if (delta.y() < 0) {
      // 上方向へスワイプ
    }
  } else if (event->type() == QEvent::TouchEnd) {
    // タッチ終了
  }
});

Qt Quick / Qt Declarative

import QtQuick 2.15

Item {
  width: 640
  height: 480

  // スワイプジェスチャー設定
  Flickable {
    onFlicked: {
      if (flickDirection === Qt.Left) {
        // 左方向へスワイプ
      } else if (flickDirection === Qt.Right) {
        // 右方向へスワイプ
      } else if (flickDirection === Qt.Up) {
        // 上方向へスワイプ
      } else if (flickDirection === Qt.Down) {
        // 下方向へスワイプ
      }
    }
  }
}

どの方法を使うべきかは、開発するアプリケーションや、スワイプジェスチャーの利用方法によって異なります。

• QSwipeGesture::SwipeDirection enumは、最もシンプルで使いやすい方法です。
• QMouseEvent::pos()は、より細かい制御が必要な場合に便利です。
• QTouchGestureは、マルチタッチジェスチャーも処理したい場合に便利です。
• Qt Quick / Qt Declarativeは、QMLでスワイプジェスチャーを処理したい場合に便利です。

それぞれの方法のメリットとデメリットを比較して、最適な方法を選びましょう。