Qt/C++ による GUI ソフト 2：メニューバー

インフォメーション

ドキュメント

Menus Example は即参考になりそうです．
以下は，メニューを作成するのに使われる関数やクラスへのリンクです．

• QMainWindow Class の QMenuBar *QMainWindow::menuBar() const 関数でメニューバーを取得
• QMenuBar Class
• QMenu Class
• QAction Class：「終了」や「開く」といったアクション

Qt のオブジェクトがいくつか出てくるので，関係を整理しておきます．

1. 独自クラス Main_Window は QMainWindow を継承しています
2. その基底となったクラス QMainWindow からは，メニューバー QMenuBar へのポインタが取得できます
3. QMenuBar には，[ファイル] や [表示] といったメニュー QMenu が追加できます
4. QMenu には，[終了] や [開く] といったアクション QAction が追加できます

Qt では，「メニュー項目を選んで実行」といった感じで表現する操作は，「QAction を選んで操作」ということになります．

インフォメーション

インストールした Debian パッケージ

このページは Debian 13 trixie で作成しています．

目次（ページ内リンク）

• 空のメニューバーを作成
• メニューバーにメニューを追加：メニューバーに [ファイル(F)] を追加します
• メニューにアクションを追加：[ファイル(F)] のなかに [開く(O)] と [終了(Q)] を作成します

空のメニューバーを作成

メニューバーを作成するには，QMainWindow クラスに定義されている QMenuBar *QMainWindow::menuBar() const という関数を使います．
この関数は QMainWindow クラスの公開メンバ関数です．メニューバーが作成されていない場合は，空のメニューバーを作成してそのポインタを返すとのことです．

ソースコード

練習 1 で作成した，QMainWindow を継承する独自クラス Main_Window に 3 か所追加すると空のメニューバーが作成できます．赤字の箇所が追加したコードです．
これらのファイルが tmp というディレクトリに入っていると想定します．

main_window.h

#include <QMainWindow>
#include <QMenuBar>

class Main_Window : public QMainWindow {
 private:
  QMenuBar *menu_bar;  //メニューバーへのポインタを宣言

 public:
  Main_Window(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags());
};

main_window.cc

メニューバーへのポインタは，QMenuBar *QMainWindow::menuBar() const で取得しています．メニューバーが作成されていない場合は，空のメニューバーが作成されて返ってきます．

#include "main_window.h"

Main_Window::Main_Window(QWidget *parent, Qt::WindowFlags f)
 : QMainWindow(parent, f),
   menu_bar(menuBar())  //コンストラクタで，ヘッダで宣言した *menu_bar に menuBar() の戻り値を代入している
{
 resize(320, 240);
 setWindowTitle("Main_Window");
}

main.cc

#include "main_window.h"
#include <QApplication>

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

 Main_Window window(nullptr, Qt::Window);
 window.show();

 return app.exec();
}

tmp.pro

TEMPLATE = app
TARGET = my_window
INCLUDEPATH += .
QT += widgets
SOURCES += main.cc main_window.cc
HEADERS += main_window.h

ビルドと実行

ここでは．Makefile 作成ツールとして qmake を使っています．qmake の使い方は qmake を使ったビルドにまとめています．
プロジェクトファイル（ここでは tmp.pro）が作成してあれば，ビルドと実行は以下の手順です．
~/tmp$ qmake6
~/tmp$ make
~/tmp$ ./my_window &

画像は実行イメージです．
空のメニューバーを作っただけでは，メニューバーは表示されませんでした．

メニューバーにメニューを追加

上のセクションで作成したメニューバーに [ファイル(F)] および [表示(V)] というメニューを追加します．
メニューは，QMenu クラス をインスタンス化します．
[ファイル(F)] を例に取ると，QMenu *file_menu を生成し，QMenuBar ::addMenu() を使って QMenuBar *menu_bar に追加しています．

ソースコード

main_window.h

#include <QMainWindow>
#include <QMenuBar>

class Main_Window : public QMainWindow {
 private:
  QMenuBar *menu_bar;
  QMenu *file_menu;  //メニューの宣言
  QMenu *view_menu;

 public:
  Main_Window(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags());
};

main_window.cc

QMenu のコンストラクタは 2 種類あって，ここでは QMenu(const QString &title, QWidget *parent = nullptr) を使いました．
もう一つは，QWidget *parent = nullptr のみを引数とするものです．

QAction *QMenuBar::addMenu(QMenu *menu) を見たら，QAction が返却されてきます．説明を読むと，「メニューの menuAction() を返します．返された QAction オブジェクトは，対応するメニューを非表示にするために使用できます」とのことです．

#include "main_window.h"

Main_Window::Main_Window(QWidget *parent, Qt::WindowFlags f)
 : QMainWindow(parent, f),
   menu_bar(menuBar())
{
 resize(320, 240);
 setWindowTitle("Main_Window");

  //メニューの作成
 file_menu = new QMenu("ファイル(&F)", this);  //&F と記すと Alt + F がキーボードショートカットになる
 menu_bar->addMenu(file_menu);  //メニューバーに [ファイル(F)] メニューを追加

 view_menu = new QMenu("表示(&V)", this);  //&V と記すと Alt + V がキーボードショートカットになる
 menu_bar->addMenu(view_menu);  //メニューバーに [表示(V)] メニューを追加
}

main.cc および window.pro

変更がないので省略します．

ビルドと実行

手順は上と同じです．
~/tmp$ qmake6
~/tmp$ make
~/tmp$ ./my_window &

画像は実行イメージです．ファイルメニューが表示されました．どうやらうまく行ったようです．

メニューにをマウスポインタを置いたり，キーボードで Alt + F あるいは Alt + V を押すと，色が変わって選択状態となります．
メニューバーの空いた部分をクリックすると，選択が解除されます．ESC キーでも解除されます．
ただ，ここで作成したファイルメニューは，まだ入れ物です．それ以上の機能はありません．

メニューにアクションを追加

メニューの中に，アクション == QAction クラスのインスタンスを追加します．

• [ファイル(F)]-[終了(Q)]
• [表示(V)]-[ON(N)] および [表示(V)]-[OFF(F)]

この例では [ファイル(F)] と [表示(V)] がメニューであり，[終了(Q)]，[ON(N)]，および [OFF(F)] がアクションです．
メニューは上のセクションで作成済みです．アクションを新規作成します．

ソースコード

main_window.h

#include <QMainWindow>
#include <QMenuBar>

class Main_Window : public QMainWindow {
 private:
  QMenuBar *menu_bar;
  QMenu *file_menu;
  QMenu *view_menu;
  QAction *action_quit;  //アクションの宣言
  QAction *action_ball_stick;
  QAction *action_spacefill;

 public:
  Main_Window(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags());
};

main_window.cc

ここで使っているコンストラクタは，QAction::QAction(const QString &text, QObject *parent = nullptr) です．const QString &text がメニューアクションとして表示されることになります．
生成したアクションは，void QWidget::addAction(QAction *action) を使ってメニューに追加されます．

アクションはデフォルトで有効になっているのですが，void QAction::setEnabled(bool) で有効/無効を変更できます．
この関数は Public Slots です．何らかのシグナルで有効/無効を変更することを前提とした仕様のようです．

#include "main_window.h"

Main_Window::Main_Window(QWidget *parent, Qt::WindowFlags f)
 : QMainWindow(parent, f),
   menu_bar(menuBar())
{
 resize(320, 240);
 setWindowTitle("Main_Window");

 file_menu = new QMenu("ファイル(&F)", this);
 menu_bar->addMenu(file_menu);

 view_menu = new QMenu("表示(&V)", this);
 menu_bar->addMenu(view_menu);

 action_quit = new QAction("終了(&Q)", this);  //アクションの生成
 file_menu->addAction(action_quit); //メニューにアクションを追加

 action_ball_stick = new QAction("棒球(&B)", this);
 action_ball_stick->setEnabled(false);  //アクションの無効化
 view_menu->addAction(action_ball_stick);;

 action_spacefill = new QAction("空間充填(&S)", this);
 view_menu->addAction(action_spacefill);;
}

main.cc および window.pro

変更が無いので省略します．

ビルドと実行

手順は上と同じです．
~/tmp$ qmake6
~/tmp$ make
~/tmp$ ./my_window &

画像は実行して [表示{V)] を選択したところです．2 個のアクション [棒球(B)] と [空間充填(S)] が表示されました．
[空間充填(S)] が途切れています．何か表示幅を設定する機能があるのでしょう．
[棒球(B)] が無効化されているので，選択もできなくなっています．色が薄くなっており，マウスカースルをポイントしても色が変わりません．
ここで作成したアクションは，まだ雛形で動作しません．次のページ，3:シグナルとスロットで動作するようにします．