Qt Widgetsで修飾キーを検出する：QGraphicsSceneHoverEvent::modifiers()の使い方

Qt WidgetsにおけるQGraphicsSceneHoverEvent::modifiers()の解説

QGraphicsSceneHoverEvent::modifiers()は、Qt Widgetsフレームワークにおけるイベント処理関数の一つです。これは、マウスがホバーイベントを起こした際に、同時に押されている修飾キーを取得するために使用されます。

詳細

QGraphicsSceneHoverEvent::modifiers()は、Qt::KeyboardModifier型のフラグを返す関数です。このフラグは、押されている修飾キーを表します。

使用例

void MyGraphicsView::mouseMoveEvent(QMouseEvent *event)
{
  QGraphicsSceneHoverEvent *hoverEvent = static_cast<QGraphicsSceneHoverEvent*>(event);

  // マウスカーソルがホバリングしているアイテムを取得
  QGraphicsItem *item = scene()->itemAt(event->pos());

  if (item) {
    // 修飾キーの状態を取得
    Qt::KeyboardModifiers modifiers = hoverEvent->modifiers();

    // Ctrlキーが押されている場合
    if (modifiers & Qt::ControlModifier) {
      // アイテムをドラッグする処理
      ...
    } else {
      // アイテム情報を表示する処理
      ...
    }
  }
}

補足

• Qt::KeyboardModifier型のフラグは、Qt::Modifier enum typeで定義されています。

• 使用可能なフラグは以下の通りです。

  • Qt::ShiftModifier
  • Qt::ControlModifier
  • Qt::AltModifier
  • Qt::KeypadModifier
  • Qt::GroupSwitchModifier

• 複数の修飾キーが同時に押されている場合は、フラグがビット演算でORされます。

Qt WidgetsにおけるQGraphicsSceneHoverEvent::modifiers()のサンプルコード

コード例1：修飾キーに応じてアイテムの処理を変える

#include <QtWidgets>

class MyGraphicsItem : public QGraphicsItem
{
public:
  MyGraphicsItem() {}

  void mouseMoveEvent(QGraphicsSceneMouseEvent *event) override
  {
    QGraphicsSceneHoverEvent *hoverEvent = static_cast<QGraphicsSceneHoverEvent*>(event);

    // 修飾キーの状態を取得
    Qt::KeyboardModifiers modifiers = hoverEvent->modifiers();

    // Ctrlキーが押されている場合
    if (modifiers & Qt::ControlModifier) {
      // アイテムをドラッグする処理
      ...
    } else {
      // アイテム情報を表示する処理
      ...
    }
  }
};

class MyGraphicsView : public QGraphicsView
{
public:
  MyGraphicsView()
  {
    setScene(new QGraphicsScene());

    // アイテムを追加
    MyGraphicsItem *item = new MyGraphicsItem();
    scene()->addItem(item);
  }
};

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

  MyGraphicsView view;
  view.show();

  return app.exec();
}

コード例2：修飾キーをマスクして特定のキーのみを取得

#include <QtWidgets>

class MyGraphicsItem : public QGraphicsItem
{
public:
  MyGraphicsItem() {}

  void mouseMoveEvent(QGraphicsSceneMouseEvent *event) override
  {
    QGraphicsSceneHoverEvent *hoverEvent = static_cast<QGraphicsSceneHoverEvent*>(event);

    // 修飾キーの状態を取得
    Qt::KeyboardModifiers modifiers = hoverEvent->modifiers();

    // Shiftキーのみを取得
    Qt::KeyboardModifier mask = Qt::ShiftModifier;
    modifiers &= mask;

    // Shiftキーが押されている場合
    if (modifiers) {
      // 処理を行う
      ...
    }
  }
};

class MyGraphicsView : public QGraphicsView
{
public:
  MyGraphicsView()
  {
    setScene(new QGraphicsScene());

    // アイテムを追加
    MyGraphicsItem *item = new MyGraphicsItem();
    scene()->addItem(item);
  }
};

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

  MyGraphicsView view;
  view.show();

  return app.exec();
}

コード例3：複数の修飾キーの組み合わせを検出

#include <QtWidgets>

class MyGraphicsItem : public QGraphicsItem
{
public:
  MyGraphicsItem() {}

  void mouseMoveEvent(QGraphicsSceneMouseEvent *event) override
  {
    QGraphicsSceneHoverEvent *hoverEvent = static_cast<QGraphicsSceneHoverEvent*>(event);

    // 修飾キーの状態を取得
    Qt::KeyboardModifiers modifiers = hoverEvent->modifiers();

    // CtrlキーとAltキーが同時に押されている場合
    if (modifiers & Qt::ControlModifier && modifiers & Qt::AltModifier) {
      // 処理を行う
      ...
    }
  }
};

class MyGraphicsView : public QGraphicsView
{
public:
  MyGraphicsView()
  {
    setScene(new QGraphicsScene());

    // アイテムを追加
    MyGraphicsItem *item = new MyGraphicsItem();
    scene()->addItem(item);
  }
};

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

  MyGraphicsView view;
  view.show();

  return app.exec();
}

これらのサンプルコードを参考に、QGraphicsSceneHoverEvent::modifiers()関数を使って、さまざまな

QGraphicsSceneHoverEvent::modifiers()の代替方法

QEvent::modifiers()を使う

QGraphicsSceneHoverEventクラスはQEventクラスを継承しているので、QEvent::modifiers()関数を使って修飾キーの状態を取得することができます。

void MyGraphicsItem::mouseMoveEvent(QGraphicsSceneMouseEvent *event) override
{
  // 修飾キーの状態を取得
  Qt::KeyboardModifiers modifiers = event->modifiers();

  // ...
}

QInputEvent::modifiers()を使う

QGraphicsSceneHoverEventクラスはQInputEventクラスを継承しているので、QInputEvent::modifiers()関数を使って修飾キーの状態を取得することができます。

void MyGraphicsItem::mouseMoveEvent(QGraphicsSceneMouseEvent *event) override
{
  // 修飾キーの状態を取得
  Qt::KeyboardModifiers modifiers = event->inputEvent()->modifiers();

  // ...
}

QKeyEvent::modifiers()を使う

マウスイベントの場合、QKeyEvent::modifiers()関数は使用できません。

Qt::KeyboardModifier enum typeを使って、個々の修飾キーの状態をチェックすることができます。

void MyGraphicsItem::mouseMoveEvent(QGraphicsSceneMouseEvent *event) override
{
  // Shiftキーが押されているかどうかをチェック
  if (event->modifiers() & Qt::ShiftModifier) {
    // 処理を行う
    ...
  }

  // Ctrlキーが押されているかどうかをチェック
  if (event->modifiers() & Qt::ControlModifier) {
    // 処理を行う
    ...
  }

  // ...
}

• QGraphicsSceneHoverEvent::modifiers()関数は、Qt Widgetsフレームワークのみに存在します。Qt Quickでは使用できません。
• Qt Quickで修飾キーの状態を取得するには、Qt::KeyboardModifier enum typeを使用する必要があります。