Qt WidgetsにおけるQTapAndHoldGesture::position

Qt WidgetsにおけるQTapAndHoldGesture::position

仕組み

QTapAndHoldGesture ジェスチャーが開始されると、QTapAndHoldGesture::position プロパティは、ジェスチャー開始時のタッチスクリーン上の座標を QPoint 型で返します。この座標は、ウィジェットの左上隅を原点としたローカル座標系で表現されます。

使用例

QTapAndHoldGesture::position プロパティは、長押しジェスチャーが発生した場所に応じて異なる処理を実行したい場合に使用できます。例えば、以下のようなコードは、長押しジェスチャーが発生した場所にメニューを表示します。

void Widget::on_tapAndHoldGesture_activated(const QTapAndHoldGesture &gesture)
{
  QPoint position = gesture.position();
  QMenu menu(this);
  menu.addAction("Copy");
  menu.addAction("Paste");
  menu.exec(position);
}

• QTapAndHoldGesture クラスには、position プロパティの他に、ジェスチャーの開始時間や終了時間、ジェスチャーの状態などを取得するためのプロパティが用意されています。

補足

• 上記のコードは、Qt 5.15 以降で動作します。
• Qt のバージョンによって、プロパティやメソッドの動作が異なる場合があります。

QTapAndHoldGesture::position プロパティは、長押しジェスチャーの発生位置を取得するための便利なプロパティです。このプロパティを活用することで、長押しジェスチャーが発生した場所に応じて異なる処理を実行することができます。

QTapAndHoldGesture::position を使用したサンプルコード

#include <QtWidgets>

class Widget : public QWidget {
  Q_OBJECT

public:
  Widget() {
    // ラベルを作成
    label = new QLabel(this);
    label->setText("座標: ");

    // タップアンドホールドジェスチャーを作成
    tapAndHoldGesture = new QTapAndHoldGesture(this);
    connect(tapAndHoldGesture, &QTapAndHoldGesture::activated, this, &Widget::on_tapAndHoldGesture_activated);
  }

private slots:
  void on_tapAndHoldGesture_activated(const QTapAndHoldGesture &gesture) {
    // ジェスチャー発生時の座標を取得
    QPoint position = gesture.position();

    // ラベルに座標を表示
    label->setText(QString("座標: (%1, %2)").arg(position.x()).arg(position.y()));
  }

private:
  QLabel *label;
  QTapAndHoldGesture *tapAndHoldGesture;
};

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

  Widget widget;
  widget.show();

  return app.exec();
}

長押しジェスチャー発生時にメニューを表示

#include <QtWidgets>

class Widget : public QWidget {
  Q_OBJECT

public:
  Widget() {
    // タップアンドホールドジェスチャーを作成
    tapAndHoldGesture = new QTapAndHoldGesture(this);
    connect(tapAndHoldGesture, &QTapAndHoldGesture::activated, this, &Widget::on_tapAndHoldGesture_activated);
  }

private slots:
  void on_tapAndHoldGesture_activated(const QTapAndHoldGesture &gesture) {
    // ジェスチャー発生時の座標を取得
    QPoint position = gesture.position();

    // メニューを作成
    QMenu menu(this);
    menu.addAction("コピー");
    menu.addAction("貼り付け");

    // メニューをジェスチャー発生位置に表示
    menu.exec(position);
  }

private:
  QTapAndHoldGesture *tapAndHoldGesture;
};

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

  Widget widget;
  widget.show();

  return app.exec();
}

長押しジェスチャー発生時に画像を回転

#include <QtWidgets>
#include <QPixmap>

class Widget : public QWidget {
  Q_OBJECT

public:
  Widget() {
    // 画像を表示するラベルを作成
    label = new QLabel(this);
    label->setPixmap(QPixmap("image.png"));

    // タップアンドホールドジェスチャーを作成
    tapAndHoldGesture = new QTapAndHoldGesture(this);
    connect(tapAndHoldGesture, &QTapAndHoldGesture::activated, this, &Widget::on_tapAndHoldGesture_activated);
  }

private slots:
  void on_tapAndHoldGesture_activated(const QTapAndHoldGesture &gesture) {
    // 画像を回転
    QPixmap pixmap = label->pixmap();
    pixmap.transformed(QTransform().rotate(45));
    label->setPixmap(pixmap);
  }

private:
  QLabel *label;
  QTapAndHoldGesture *tapAndHoldGesture;
};

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

  Widget widget;
  widget.show();

  return app.exec();
}

これらのサンプルコードは、QTapAndHoldGesture::position プロパティを使用して、長押しジェスチャー発生時の座標を取得する方法を示しています。これらのサンプルコードを参考に、さまざまなアプリケーションで長押しジェスチャーを活用してください。

QTapAndHoldGesture::position 以外の方法

QMouseEvent::pos() を使用する

QTapAndHoldGesture クラスは、QMouseEvent を継承しています。そのため、QTapAndHoldGesture::activated() シグナルのスロット内で、QMouseEvent::pos() メソッドを使用して、ジェスチャー発生時の座標を取得することができます。

void on_tapAndHoldGesture_activated(const QTapAndHoldGesture &gesture) {
  // ジェスチャー発生時のイベントを取得
  const QMouseEvent *event = gesture.event();

  // イベントから座標を取得
  QPoint position = event->pos();

  // ...
}

QGestureEvent::mapToWidget() を使用する

QTapAndHoldGesture::activated() シグナルのスロット内で、QGestureEvent::mapToWidget() メソッドを使用して、ジェスチャー発生時の座標をウィジェットのローカル座標系に変換することができます。

void on_tapAndHoldGesture_activated(const QTapAndHoldGesture &gesture) {
  // ジェスチャー発生時のイベントを取得
  const QGestureEvent *event = gesture.event();

  // イベントから座標を取得
  QPoint position = event->position();

  // 座標をウィジェットのローカル座標系に変換
  position = mapToWidget(position);

  // ...
}

QGestureRecognizer::gesturePosition() を使用する

QTapAndHoldGesture クラスは、QGestureRecognizer クラスを継承しています。そのため、QTapAndHoldGesture::gestureRecognizer() メソッドを使用して、QGestureRecognizer オブジェクトを取得し、QGestureRecognizer::gesturePosition() メソッドを使用して、ジェスチャー発生時の座標を取得することができます。

void on_tapAndHoldGesture_activated(const QTapAndHoldGesture &gesture) {
  // ジェスチャー認識オブジェクトを取得
  QGestureRecognizer *recognizer = gesture.gestureRecognizer();

  // 座標を取得
  QPoint position = recognizer->gesturePosition();

  // ...
}

これらの方法は、それぞれ異なる利点と欠点があります。どの方法を使用するかは、アプリケーションの要件によって異なります。

QTapAndHoldGesture::position は、最もシンプルで使いやすい方法です。

QMouseEvent::pos() は、より多くの情報を取得することができますが、コードが複雑になります。

QGestureEvent::mapToWidget() は、ウィジェットのローカル座標系での座標を取得することができます。

QGestureRecognizer::gesturePosition() は、ジェスチャー認識オブジェクトに関する情報を取得することができます。

これらの方法を参考に、アプリケーションに合った方法を選択してください。