Qt WidgetsにおけるQGraphicsSceneContextMenuEvent::pos()とは？

Qt WidgetsにおけるQGraphicsSceneContextMenuEvent::pos()の解説

概要

• クラス: QGraphicsSceneContextMenuEvent
• 関数: pos()
• 戻り値: QPointF型 - イベントが発生したシーン上の座標
• 用途: コンテキストメニューを表示する場所を決定する

詳細

QGraphicsSceneContextMenuEvent::pos()は、イベントが発生したシーン座標をQPointF型で返します。この座標は、ウィジェット座標とは異なることに注意が必要です。ウィジェット座標は、ウィジェットの左上隅を原点とする座標系です。一方、シーン座標は、シーンの左上隅を原点とする座標系です。

コード例

void MyGraphicsView::contextMenuEvent(QContextMenuEvent *event)
{
  // イベントが発生したシーン上の座標を取得
  QPointF scenePos = event->scenePos();

  // シーン上の座標に基づいて、コンテキストメニューを表示する
  QMenu menu(this);
  menu.addAction("Copy");
  menu.addAction("Paste");
  menu.exec(event->screenPos());
}

上記のコード例では、**contextMenuEvent()**イベントハンドラ内で、**pos()**関数を使用してイベント発生時のシーン座標を取得しています。その後、その座標に基づいて、コンテキストメニューを表示しています。

補足

• QGraphicsSceneContextMenuEvent::posF()は、pos()と同様の機能を提供しますが、浮動小数点数の座標を返します。
• QGraphicsSceneContextMenuEvent::screenPos()は、イベントが発生したスクリーン上の座標を返します。

QGraphicsSceneContextMenuEvent::pos()を使用したサンプルコード

コンテキストメニューを表示する

void MyGraphicsView::contextMenuEvent(QContextMenuEvent *event)
{
  // イベントが発生したシーン上の座標を取得
  QPointF scenePos = event->scenePos();

  // シーン上の座標に基づいて、コンテキストメニューを表示する
  QMenu menu(this);
  menu.addAction("Copy");
  menu.addAction("Paste");
  menu.exec(event->screenPos());
}

アイテムを選択してコンテキストメニューを表示する

void MyGraphicsView::mousePressEvent(QMouseEvent *event)
{
  if (event->button() == Qt::MouseButton::RightButton) {
    // マウスが押されたシーン上の座標を取得
    QPointF scenePos = event->scenePos();

    // アイテムを取得
    QGraphicsItem *item = graphicsScene()->itemAt(scenePos);

    // アイテムが選択されている場合は、コンテキストメニューを表示する
    if (item) {
      QMenu menu(this);
      menu.addAction("Item Action 1");
      menu.addAction("Item Action 2");
      menu.exec(event->screenPos());
    }
  }
}

カスタムメニュー項目を追加する

void MyGraphicsView::contextMenuEvent(QContextMenuEvent *event)
{
  // イベントが発生したシーン上の座標を取得
  QPointF scenePos = event->scenePos();

  // シーン上の座標に基づいて、コンテキストメニューを表示する
  QMenu menu(this);
  menu.addAction("Copy");
  menu.addAction("Paste");

  // カスタムメニュー項目を追加
  QAction *customAction = new QAction("Custom Action", this);
  menu.addAction(customAction);

  // カスタムアクションの処理
  connect(customAction, &QAction::triggered, [this, scenePos]() {
    // ここにカスタム処理を記述
    // 例：選択したアイテムを削除する
    QGraphicsItem *item = graphicsScene()->itemAt(scenePos);
    if (item) {
      graphicsScene()->removeItem(item);
    }
  });

  menu.exec(event->screenPos());
}

メニュー項目を動的に追加する

void MyGraphicsView::contextMenuEvent(QContextMenuEvent *event)
{
  // イベントが発生したシーン上の座標を取得
  QPointF scenePos = event->scenePos();

  // シーン上の座標に基づいて、コンテキストメニューを表示する
  QMenu menu(this);

  // アイテムリストを取得
  QList<QGraphicsItem *> items = graphicsScene()->items(scenePos);

  // アイテムリストに基づいて、メニュー項目を動的に追加
  for (QGraphicsItem *item : items) {
    QAction *itemAction = new QAction(item->data(Qt::UserRole).toString(), this);
    menu.addAction(itemAction);

    // アイテムアクションの処理
    connect(itemAction, &QAction::triggered, [this, item]() {
      // ここにアイテムごとの処理を記述
      // 例：アイテムの色を変更する
      item->setBrush(QColor::red);
    });
  }

  menu.exec(event->screenPos());
}

QGraphicsSceneContextMenuEvent::pos() 以外の方法

QGraphicsScene::customContextMenuRequested() シグナルは、コンテキストメニューが表示される前に発行されます。このシグナルハンドラ内で、イベント発生時のシーン座標を取得し、カスタムメニューを表示することができます。

void MyGraphicsScene::customContextMenuRequested(QGraphicsSceneContextMenuEvent *event)
{
  // イベントが発生したシーン上の座標を取得
  QPointF scenePos = event->scenePos();

  // カスタムメニューを表示する
  QMenu menu(this);
  menu.addAction("Copy");
  menu.addAction("Paste");
  menu.exec(event->screenPos());
}

QGraphicsItem::contextMenuEvent() イベントハンドラは、アイテム上でコンテキストメニューが表示される時に呼び出されます。このイベントハンドラ内で、イベント発生時のシーン座標を取得し、カスタムメニューを表示することができます。

void MyGraphicsItem::contextMenuEvent(QGraphicsSceneContextMenuEvent *event)
{
  // イベントが発生したシーン上の座標を取得
  QPointF scenePos = event->scenePos();

  // カスタムメニューを表示する
  QMenu menu(this);
  menu.addAction("Item Action 1");
  menu.addAction("Item Action 2");
  menu.exec(event->screenPos());
}

QMouseEvent::MouseButton::RightButton フラグを使用して、右クリックされた場所を取得することができます。

void MyGraphicsView::mousePressEvent(QMouseEvent *event)
{
  if (event->button() == Qt::MouseButton::RightButton) {
    // マウスが押されたシーン上の座標を取得
    QPointF scenePos = event->scenePos();

    // シーン上の座標に基づいて、コンテキストメニューを表示する
    QMenu menu(this);
    menu.addAction("Copy");
    menu.addAction("Paste");
    menu.exec(event->screenPos());
  }
}

これらの方法は、QGraphicsSceneContextMenuEvent::pos() 以外にも、コンテキストメニューを表示する際に役立ちます。