【保存版】Qt Widgetsでツールボタンを思い通りに操る！QMainWindow::toolButtonStyleChanged()の活用術

QMainWindow::toolButtonStyleChanged() は、QMainWindow クラスが提供するシグナルで、メインウィンドウ内のツールボタンのスタイルが変更されたときに発生します。このシグナルは、ツールボタンの外観をアプリケーション全体で統一したい場合に役立ちます。

シグナルの引数

toolButtonStyleChanged() シグナルは、以下の引数を渡します。

toolButtonStyle: 新しいツールボタンスタイルを表す Qt::ToolButtonStyle 型の値

接続例

以下のコード例は、toolButtonStyleChanged() シグナルをスロットに接続し、新しいスタイルをすべてのツールボタンに適用する方法を示しています。

void MainWindow::onToolButtonStyleChanged(Qt::ToolButtonStyle style) {
  for (QToolBar *toolbar : toolBars()) {
    for (QAction *action : toolbar->actions()) {
      action->setIcon(style == Qt::ToolButtonIconOnly ? action->icon() : QIcon());
    }
  }
}

このコードでは、onToolButtonStyleChanged() スロットは、toolButtonStyle 引数に基づいて、各ツールボタンのアイコンを設定します。 Qt::ToolButtonIconOnly スタイルの場合は、アイコンのみが表示されます。それ以外の場合は、アイコンは表示されません。

ツールボタンのスタイルは、Qt::ToolButtonStyle 列挙型で定義されています。この列挙型には、Qt::ToolButtonDefault、Qt::ToolButtonIconOnly、Qt::ToolButtonTextOnly、Qt::ToolButtonMenu などの値が含まれています。
QMainWindow クラスには、ツールボタンのスタイルを設定するための setToolButtonStyle() メソッドも用意されています。

ツールボタンのスタイルをすべてアイコンのみに変更する

void MainWindow::onToolButtonStyleChanged(Qt::ToolButtonStyle style) {
  for (QToolBar *toolbar : toolBars()) {
    for (QAction *action : toolbar->actions()) {
      action->setIcon(style == Qt::ToolButtonIconOnly ? action->icon() : QIcon());
    }
  }
}

スタイル変更に応じてツールチップのテキストを変更する

void MainWindow::onToolButtonStyleChanged(Qt::ToolButtonStyle style) {
  for (QToolBar *toolbar : toolBars()) {
    for (QAction *action : toolbar->actions()) {
      action->setToolTip(style == Qt::ToolButtonIconOnly
                        ? action->text() : action->toolTip());
    }
  }
}

このコード例は、toolButtonStyleChanged() シグナルをスロットに接続し、スタイル変更に応じてツールチップのテキストを変更する方法を示しています。 Qt::ToolButtonIconOnly スタイルの場合は、ツールチップにボタンのテキストが表示されます。それ以外の場合は、ツールチップに設定されているテキストが表示されます。

void MainWindow::onToolButtonStyleChanged(Qt::ToolButtonStyle style) {
  for (QToolBar *toolbar : toolBars()) {
    if (style == Qt::ToolButtonIconOnly) {
      toolbar->layoutDirection() = Qt::LayoutDirection::LeftToRight;
    } else {
      toolbar->layoutDirection() = Qt::LayoutDirection::TopToBottom;
    }
  }
}

ツールバーのスタイルを設定する

ツールバー全体のスタイルを設定するには、QToolBar::setStyle() メソッドを使用できます。このメソッドを使用すると、ツールバー内のすべてのツールボタンのスタイルが自動的に更新されます。

toolbar->setStyle(Qt::ToolButtonStyle::ToolButtonIconOnly);

ツールボタンのスタイルを個別に設定する

個々のツールボタンのスタイルを設定するには、QToolButton::setStyle() メソッドを使用できます。このメソッドを使用すると、選択したツールボタンのスタイルのみが変更されます。

for (QAction *action : toolbar->actions()) {
  action->toolButton()->setStyle(Qt::ToolButtonStyle::ToolButtonIconOnly);
}

スタイルシートを使用する

スタイルシートを使用して、ツールボタンの外観を個別に設定することもできます。スタイルシートは、CSS に似た構文を使用して、ウィジェットの外観を制御するのに役立ちます。

QToolBar QToolButton {
  icon-size: 32px;
  border: none;
  padding: 5px;
}

カスタムシグナルを作成する

独自のシグナルを作成して、ツールボタンのスタイル変更を検知することもできます。この方法を使用すると、より柔軟な制御が可能になりますが、より多くのコーディングが必要になります。

スタイル変更に応じてより複雑なロジックを実行する必要がある場合は、カスタムシグナルを作成する必要があります。
個々のツールボタンのスタイルを個別に設定したい場合は、QToolButton::setStyle() メソッドまたはスタイルシートを使用する必要があります。
ツールバー全体のスタイルを統一したい場合は、QToolBar::setStyle() メソッドを使用するのが最も簡単です。

スタイルシートを使用するには、Qt 4.6 以降が必要です。
QMainWindow::toolButtonStyleChanged() シグナルは、Qt 5.4 以降でのみ使用できます。