Qt WidgetsにおけるQSwipeGesture::swipeAngleの解説

Qt WidgetsにおけるQSwipeGesture::swipeAngle解説

用途

swipeAngle は、スワイプの方向に基づいて異なるアクションを実行する必要がある場合に役立ちます。例えば、以下のような用途が考えられます。

• スワイプの方向に応じて、画面遷移を切り替える
• スワイプの方向に応じて、画像を回転させる
• スワイプの方向に応じて、リストをスクロールする

使い方

swipeAngle は、QSwipeGesture オブジェクトから呼び出すことができます。以下のコード例では、スワイプの方向を取得し、その方向に応じてラベルのテキストを変更しています。

#include <QtWidgets>

int main(int argc, char** argv) {
  QApplication app(argc, argv);

  // ウィジェットとラベルを作成
  QWidget window;
  QLabel label("スワイプの方向を表示");
  label.setAlignment(Qt::AlignCenter);

  // スワイプジェスチャーを設定
  QSwipeGesture gesture(&window);
  gesture.connect(&gesture, &QSwipeGesture::swiped, [&](Qt::GestureDirection direction) {
    // スワイプの方向に応じてラベルのテキストを変更
    switch (direction) {
      case Qt::GestureDirection::Left:
        label.setText("左にスワイプしました");
        break;
      case Qt::GestureDirection::Right:
        label.setText("右にスワイプしました");
        break;
      case Qt::GestureDirection::Up:
        label.setText("上にスワイプしました");
        break;
      case Qt::GestureDirection::Down:
        label.setText("下にスワイプしました");
        break;
    }
  });

  // ウィジェットを表示
  window.show();

  return app.exec();
}

戻り値

• swipeAngle は、スワイプ開始点と終了点間の直線を基準に角度を計算します。
• スワイプの方向をより正確に取得するには、QSwipeGesture::horizontalSwipeThreshold や QSwipeGesture::verticalSwipeThreshold などのプロパティを設定する必要があります。
• Qtには、スワイプジェスチャー以外にも様々なジェスチャーを処理するためのクラスが用意されています。詳細は、Qt Widgetsドキュメントのジェスチャーに関する章を参照してください。

Qt WidgetsにおけるQSwipeGesture::swipeAngleを使ったサンプルコード

スワイプ方向に応じてラベルのテキストを変更する

#include <QtWidgets>

int main(int argc, char** argv) {
  QApplication app(argc, argv);

  // ウィジェットとラベルを作成
  QWidget window;
  QLabel label("スワイプの方向を表示");
  label.setAlignment(Qt::AlignCenter);

  // スワイプジェスチャーを設定
  QSwipeGesture gesture(&window);
  gesture.connect(&gesture, &QSwipeGesture::swiped, [&](Qt::GestureDirection direction) {
    // スワイプの方向に応じてラベルのテキストを変更
    switch (direction) {
      case Qt::GestureDirection::Left:
        label.setText("左にスワイプしました");
        break;
      case Qt::GestureDirection::Right:
        label.setText("右にスワイプしました");
        break;
      case Qt::GestureDirection::Up:
        label.setText("上にスワイプしました");
        break;
      case Qt::GestureDirection::Down:
        label.setText("下にスワイプしました");
        break;
    }
  });

  // ウィジェットを表示
  window.show();

  return app.exec();
}

スワイプ方向に応じて画像を回転させる

#include <QtWidgets>
#include <QPixmap>

int main(int argc, char** argv) {
  QApplication app(argc, argv);

  // ウィジェットと画像ラベルを作成
  QWidget window;
  QLabel label;
  label.setPixmap(QPixmap("image.png"));

  // スワイプジェスチャーを設定
  QSwipeGesture gesture(&window);
  gesture.connect(&gesture, &QSwipeGesture::swiped, [&](Qt::GestureDirection direction) {
    // スワイプ方向に応じて画像を回転
    QPixmap pixmap = label.pixmap();
    switch (direction) {
      case Qt::GestureDirection::Left:
        pixmap = pixmap.transformed(QTransform().rotate(-90));
        break;
      case Qt::GestureDirection::Right:
        pixmap = pixmap.transformed(QTransform().rotate(90));
        break;
      case Qt::GestureDirection::Up:
        pixmap = pixmap.transformed(QTransform().rotate(180));
        break;
      case Qt::GestureDirection::Down:
        // 回転しない
        break;
    }
    label.setPixmap(pixmap);
  });

  // ウィジェットを表示
  window.show();

  return app.exec();
}

スワイプ方向に応じてリストをスクロールする

#include <QtWidgets>

int main(int argc, char** argv) {
  QApplication app(argc, argv);

  // ウィジェットとリストウィジェットを作成
  QWidget window;
  QListWidget listWidget;
  for (int i = 0; i < 100; i++) {
    listWidget.addItem(QString("アイテム%1").arg(i));
  }

  // スワイプジェスチャーを設定
  QSwipeGesture gesture(&listWidget);
  gesture.connect(&gesture, &QSwipeGesture::swiped, [&](Qt::GestureDirection direction) {
    // スワイプ方向に応じてリストをスクロール
    switch (direction) {
      case Qt::GestureDirection::Left:
        listWidget.scrollRight();
        break;
      case Qt::GestureDirection::Right:
        listWidget.scrollLeft();
        break;
      case Qt::GestureDirection::Up:
        listWidget.scrollUp();
        break;
      case Qt::GestureDirection::Down:
        listWidget.scrollDown();
        break;
    }
  });

  // ウィジェットを表示
  window.show();

  return app.exec();
}

QSwipeGesture::swipeAngle 以外の方法

QGestureEvent::delta() を使う

QGestureEvent::delta() は、ジェスチャーの開始点と終了点間の差分を取得します。この差分ベクトルの角度を計算することで、スワイプの方向を取得できます。

void MyWidget::gestureEvent(QGestureEvent* event) {
  if (event->gestureType() == Qt::GestureType::SwipeGesture) {
    QSwipeGesture* swipeGesture = static_cast<QSwipeGesture*>(event);
    QPointF delta = swipeGesture->delta();
    // delta.x() と delta.y() を使ってスワイプの方向を計算
  }
}

QPoint::angle() を使う

QPoint::angle() は、点と原点との間の角度を計算します。スワイプの開始点と終了点をそれぞれ QPoint オブジェクトに変換し、angle() メソッドを使って角度を取得できます。

void MyWidget::gestureEvent(QGestureEvent* event) {
  if (event->gestureType() == Qt::GestureType::SwipeGesture) {
    QSwipeGesture* swipeGesture = static_cast<QSwipeGesture*>(event);
    QPoint startPoint = swipeGesture->startPoint();
    QPoint endPoint = swipeGesture->endPoint();
    // startPoint と endPoint を使ってスワイプの方向を計算
  }
}

Qt::GestureDirection を使う

Qt::GestureDirection は、ジェスチャーの方向を表す列挙型です。QSwipeGesture::state() メソッドを使って、ジェスチャーの現在の状態を取得できます。ジェスチャーの状態が Qt::GestureState::Finished の場合、swipeDirection() メソッドを使ってスワイプの方向を取得できます。

void MyWidget::gestureEvent(QGestureEvent* event) {
  if (event->gestureType() == Qt::GestureType::SwipeGesture) {
    QSwipeGesture* swipeGesture = static_cast<QSwipeGesture*>(event);
    if (swipeGesture->state() == Qt::GestureState::Finished) {
      Qt::GestureDirection direction = swipeGesture->swipeDirection();
      // direction を使ってスワイプの方向を処理
    }
  }
}

これらの方法は、それぞれ異なる利点と欠点があります。どの方法を使うかは、具体的な要件によって異なります。

QGestureEvent::delta() は最も汎用性の高い方法ですが、計算が複雑になることがあります。

QPoint::angle() は比較的簡単な方法ですが、精度が低くなることがあります。