QAction オブジェクトの生成

QMenu への配置

• 通常は MainWindow コンストラクタから呼ばれる createMenus() の中でメニューオブジェクトの生成・設定を行う
• メニュー項目の設定は addMenu() または addAction() で行うことが出来る

   1: void MainWindow::createMenus()
   2: {
   3:     fileMenu = menuBar()->addMenu(tr("&File"));
   4:     fileMenu->addAction(newAct);
   5:     fileMenu->addAction(openAct);
   6:     .....
   7:     editMenu = menuBar()->addMenu(tr("&Edit"));
   8:     editMenu->addAction(undoAct);
   9:     editMenu->addAction(redoAct);
  10:     .....
  11: }
  

• QMainFrame::menuBar() はメインフレームメニューバーへのポインタを返す
• QAction オブジェクトにアイコンが設定されていれば、アイコンが自動的に表示される
• QAction オブジェクトがチェック可能であれば、チェック状態が自動的に表示される

  

QToolBar への配置

• 通常は MainWindow コンストラクタから呼ばれる createToolBars() の中でツールバーオブジェクトの生成・設定を行う

   1: void MainWindow::createToolBars()
   2: {
   3:     fileToolBar = addToolBar(tr("File"));   //  File ツールバー生成
   4:     fileToolBar->addAction(newAct);
   5:     fileToolBar->addAction(openAct);
   5:     ....
   6: }
  

• ツールバーの生成＆追加は QMainFrame::addToolBar(ツールバー名) により行う
• 指定したツールバー名は、ツールバーを右ボタンクリックして表示されるメニューに表示される。

  

• QToolBar::addAction() により、ツールバーにアクションオブジェクトを配置できる
• QAction オブジェクトにアイコンが設定されていれば、アイコンが自動的に表示される
• アイコンを設定せず、テキストを設定している場合は、設定したテキストが表示される

  

• QAction オブジェクトがチェック可能であれば、チェック状態が自動的に表示される
• マウスポインターをアイコンに合わせ、少し待つと下図の様に ToolTips テキストが表示される。 ToolTipsテキストが設定されていない場合は（QAction コンストラクタで指定可能な） text プロパティ文字列が表示される。

  

QToolBar

• ツールバーには QAction だけでなく、addWidget() により QLineEdit などの任意のウィジットを配置することができる。
• QToolButton を使用すると、下図のようにツールバーにドロップダウンメニューを配置することができる

  

• QToolButton::setPopupMode(QToolButton::MenuButtonPopup) で QToolButton オブジェクトにメニューを配置可能になる
• QToolButton::setMenu(QMenu * menu) でメニューツリーを設定する

   1:     gradientToolButton = new QToolButton;
   2:     gradientToolButton->setToolTip(tr("gradient"));
   3:     gradientToolButton->setPopupMode(QToolButton::MenuButtonPopup);
   4:     gradientToolButton->setMenu(createGradientMenu());
   5:     gradientAction = gradientToolButton->menu()->defaultAction();
   6:     colorToolBar->addWidget(gradientToolButton);
  

• ボタンを押したときのアクションは setDefaultAction ( QAction * action ) で設定可能
• 空のメニューを設定し、QMenu::aboutToShow() シグナルを処理してやれば、 ドロップダウンメニューでなくダイアログを表示するなどの凝ったUIも作れるらしい（筆者は未経験）

QButtonGroup, QActionGroup

• QButtonGroup を使用すると、ラジオボタンの様に複数のチェック可能なボタンの状態を排他的にすることができる
• QButtonGroup オブジェクトを生成し、排他的にしたいボタンを addButton() で追加する
• ボタンオブジェクトはツールバーに addWidget() する

   1:     //  左右アラインメント
   2:     hAlignGroup = new QButtonGroup(this);
   3:     //  左揃え
   4:     QToolButton *alignLeftButton = new QToolButton;
   5:     alignLeftButton->setToolTip(tr("align left"));
   6:     alignLeftButton->setCheckable(true);
   7:     alignLeftButton->setChecked(true);
   8:     alignLeftButton->setIcon(QIcon(":nxiiDraw/Resources/images/alignLeft.png"));
   9:     hAlignGroup->addButton(alignLeftButton, int(Qt::AlignLeft));
  10:     textToolBar->addWidget(alignLeftButton);
  11:     connect(alignLeftButton, SIGNAL(clicked()), this, SLOT(alignLeftButtonTriggered()));
  12:     //  中央揃え
  13:     QToolButton *alignCenterButton = new QToolButton;
  14:     hAlignGroup->addButton(alignCenterButton, int(Qt::AlignHCenter));
  15:     .....
  16:     //  右揃え
  17:     QToolButton *alignRightButton = new QToolButton;
  18:     hAlignGroup->addButton(alignRightButton, int(Qt::AlignRight));
  19:     .....
  

• メニューで QAction のチェック状態を排他的にしたい場合は QActionGroup を使用する。使い方は QButtonGroup とほほ同様。

   1:     pointerActGroup = new QActionGroup(this);
   2:     pointerActGroup->setExclusive(true);
   3:     pointerActGroup->addAction(pointerButtonAct);
   4:     pointerActGroup->addAction(textButtonAct);
   5:     .....
   6:     QMenu *pointer = editMenu->addMenu(tr("&Tool"));
   7:     pointer->addAction(pointerButtonAct);
   8:     pointer->addAction(textButtonAct);
   9:     .....
  

まとめ

• QAction と ToolBar に関係する QToolButton などを具体的なソースコードを示して解説した。
• QAction は簡単で強力で使いやすいことを理解していただけたと思う

次回はレイアウトのお話をする予定

演習問題