QMenuBar::triggered() シグナルの徹底解説

Qt WidgetsにおけるQMenuBar::triggered()の詳細解説

QMenuBar::triggered() は、Qt Widgets モジュールの QMenuBar クラスで定義されるシグナルです。このシグナルは、メニューバー上のメニュー項目がユーザーによって選択されたときに発生します。このシグナルを受け取るスロットは、選択されたメニュー項目に関連する処理を実行できます。

シグナルの仕組み

QMenuBar::triggered() シグナルは、QAction オブジェクトを引数として送信されます。このオブジェクトは、選択されたメニュー項目を表します。スロットはこのオブジェクトを使用して、選択された項目の情報を取得したり、項目に関連する処理を実行したりできます。

シグナルの接続

QMenuBar::triggered() シグナルは、QObject::connect() 関数を使用してスロットに接続できます。スロットは、QAction オブジェクトを受け取るシグナルハンドラ関数である必要があります。

シグナルの使用例

QMenuBar::triggered() シグナルは、さまざまな目的に使用できます。以下にいくつかの例を示します。

• メニュー項目に関連するアクションを実行する
• 選択されたメニュー項目の情報を表示する
• メニュー項目の状態を更新する

コード例

#include <QtWidgets/QApplication>
#include <QtWidgets/QMainWindow>
#include <QtWidgets/QMenuBar>
#include <QtWidgets/QMenu>
#include <QtWidgets/QAction>

class MainWindow : public QMainWindow {
  Q_OBJECT
public:
  MainWindow() {
    // メニューバーを作成
    QMenuBar* menuBar = new QMenuBar(this);

    // メニューを作成
    QMenu* fileMenu = new QMenu("ファイル");
    menuBar->addMenu(fileMenu);

    // メニュー項目を作成
    QAction* openAction = new QAction("開く", this);
    fileMenu->addAction(openAction);

    // シグナルとスロットを接続
    connect(openAction, &QAction::triggered, this, &MainWindow::onOpenActionTriggered);

    // ウィジェットを表示
    setCentralWidget(new QWidget);
    show();
  }

private slots:
  void onOpenActionTriggered() {
    // "開く"アクションが選択されたときの処理
    // ...
  }
};

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

  MainWindow mainWindow;
  return app.exec();
}

補足

• QMenuBar::triggered() シグナルは、メニュー項目がキーボードショートカットによって選択された場合にも発生します。
• メニュー項目が無効の場合は、シグナルは発生しません。
• メニュー項目がサブメニューを持つ場合、シグナルはサブメニューが選択されたときにも発生します。

Qt Widgets に関する質問は、Qt 公式フォーラム: https://forum.qt.io/ や Stack Overflow: https://stackoverflow.com/ で質問することができます。

QMenuBar::triggered() シグナルを使用したサンプルコード集

このサンプルコードでは、"ファイル"メニューの"開く"アクションを選択すると、ファイル選択ダイアログが表示されます。

#include <QtWidgets/QApplication>
#include <QtWidgets/QMainWindow>
#include <QtWidgets/QMenuBar>
#include <QtWidgets/QMenu>
#include <QtWidgets/QAction>
#include <QtWidgets/QFileDialog>

class MainWindow : public QMainWindow {
  Q_OBJECT
public:
  MainWindow() {
    // メニューバーを作成
    QMenuBar* menuBar = new QMenuBar(this);

    // メニューを作成
    QMenu* fileMenu = new QMenu("ファイル");
    menuBar->addMenu(fileMenu);

    // メニュー項目を作成
    QAction* openAction = new QAction("開く", this);
    fileMenu->addAction(openAction);

    // シグナルとスロットを接続
    connect(openAction, &QAction::triggered, this, &MainWindow::onOpenActionTriggered);

    // ウィジェットを表示
    setCentralWidget(new QWidget);
    show();
  }

private slots:
  void onOpenActionTriggered() {
    // ファイル選択ダイアログを表示
    QFileDialog dialog(this);
    dialog.exec();
  }
};

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

  MainWindow mainWindow;
  return app.exec();
}

サンプル2：選択されたメニュー項目の情報を表示する

このサンプルコードでは、メニュー項目を選択すると、その項目の名前とテキストが表示されます。

#include <QtWidgets/QApplication>
#include <QtWidgets/QMainWindow>
#include <QtWidgets/QMenuBar>
#include <QtWidgets/QMenu>
#include <QtWidgets/QAction>
#include <QMessageBox>

class MainWindow : public QMainWindow {
  Q_OBJECT
public:
  MainWindow() {
    // メニューバーを作成
    QMenuBar* menuBar = new QMenuBar(this);

    // メニューを作成
    QMenu* fileMenu = new QMenu("ファイル");
    menuBar->addMenu(fileMenu);

    // メニュー項目を作成
    QAction* openAction = new QAction("開く", this);
    fileMenu->addAction(openAction);

    // シグナルとスロットを接続
    connect(openAction, &QAction::triggered, this, &MainWindow::onOpenActionTriggered);

    // ウィジェットを表示
    setCentralWidget(new QWidget);
    show();
  }

private slots:
  void onOpenActionTriggered() {
    // 選択されたメニュー項目を取得
    QAction* action = qobject_cast<QAction*>(sender());

    // メッセージボックスを表示
    QMessageBox::information(this, "選択された項目",
      "名前: " + action->text() + "\n"
      "テキスト: " + action->toolTip());
  }
};

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

  MainWindow mainWindow;
  return app.exec();
}

サンプル3：メニュー項目の状態を更新する

このサンプルコードでは、"ファイル"メニューの"開く"アクションを選択すると、その項目のチェック状態がオンになります。

#include <QtWidgets/QApplication>
#include <QtWidgets/QMainWindow>
#include <QtWidgets/QMenuBar>
#include <QtWidgets/QMenu>
#include <QtWidgets/QAction>

class MainWindow : public QMainWindow {
  Q_OBJECT
public:
  MainWindow() {
    // メニューバーを作成
    QMenuBar* menuBar = new QMenuBar(this);

    // メニューを作成
    QMenu* fileMenu = new QMenu("ファイル");
    menuBar->addMenu(fileMenu);

    // メニュー項目を作成
    QAction* openAction = new QAction("開く", this);
    fileMenu->addAction(openAction);

    // シグナルとスロットを接続
    connect(openAction, &QAction::triggered, this, &MainWindow::onOpenActionTriggered);

    // ウィジェットを表示
    setCentralWidget(new QWidget);
    show();
  }

private slots:
  void onOpenActionTriggered() {
    // 選択されたメニュー項目を取得
    QAction* action = qobject_cast<QAction*>(sender());

    // 項目のチェック状態を更新
    action->setChecked(true);

QMenuBar::triggered() シグナルの代替方法

QAction::triggered() シグナルを使用する

QAction クラスには、triggered() シグナルも定義されています。このシグナルは、メニュー項目が選択されたときに発生します。QMenuBar::triggered() シグナルよりも、個々のメニュー項目に特化した処理を行うことができます。

#include <QtWidgets/QApplication>
#include <QtWidgets/QMainWindow>
#include <QtWidgets/QMenuBar>
#include <QtWidgets/QMenu>
#include <QtWidgets/QAction>

class MainWindow : public QMainWindow {
  Q_OBJECT
public:
  MainWindow() {
    // メニューバーを作成
    QMenuBar* menuBar = new QMenuBar(this);

    // メニューを作成
    QMenu* fileMenu = new QMenu("ファイル");
    menuBar->addMenu(fileMenu);

    // メニュー項目を作成
    QAction* openAction = new QAction("開く", this);
    fileMenu->addAction(openAction);

    // シグナルとスロットを接続
    connect(openAction, &QAction::triggered, this, &MainWindow::onOpenActionTriggered);

    // ウィジェットを表示
    setCentralWidget(new QWidget);
    show();
  }

private slots:
  void onOpenActionTriggered() {
    // 処理
  }
};

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

  MainWindow mainWindow;
  return app.exec();
}

QMenu::exec() 関数は、メニューを指定された座標で表示します。この関数は、メニュー項目が選択されるまでブロックされます。

#include <QtWidgets/QApplication>
#include <QtWidgets/QMainWindow>
#include <QtWidgets/QMenuBar>
#include <QtWidgets/QMenu>
#include <QtWidgets/QAction>

class MainWindow : public QMainWindow {
  Q_OBJECT
public:
  MainWindow() {
    // メニューバーを作成
    QMenuBar* menuBar = new QMenuBar(this);

    // メニューを作成
    QMenu* fileMenu = new QMenu("ファイル");
    menuBar->addMenu(fileMenu);

    // メニュー項目を作成
    QAction* openAction = new QAction("開く", this);
    fileMenu->addAction(openAction);

    // ウィジェットを表示
    setCentralWidget(new QWidget);
    show();
  }

private slots:
  void onOpenActionTriggered() {
    // メニューを表示
    QPoint pos = cursor().pos();
    QMenu* menu = new QMenu(this);
    menu->addAction(openAction);
    menu->exec(pos);
  }
};

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

  MainWindow mainWindow;
  return app.exec();
}

QShortcut クラスは、キーボードショートカットをメニュー項目に割り当てることができます。

#include <QtWidgets/QApplication>
#include <QtWidgets/QMainWindow>
#include <QtWidgets/QMenuBar>
#include <QtWidgets/QMenu>
#include <QtWidgets/QAction>
#include <QtWidgets/QShortcut>

class MainWindow : public QMainWindow {
  Q_OBJECT
public:
  MainWindow() {
    // メニューバーを作成
    QMenuBar* menuBar = new QMenuBar(this);

    // メニューを作成
    QMenu* fileMenu = new QMenu("ファイル");
    menuBar->addMenu(fileMenu);

    // メニュー項目を作成
    QAction* openAction = new QAction("開く", this);
    fileMenu->addAction(openAction);

    // ショートカットを作成
    QShortcut* shortcut = new QShortcut(Qt::Key_O, this);
    shortcut->