サンプルコードで学ぶ QMdiArea::activateNextSubWindow()

Qt WidgetsにおけるQMdiArea::activateNextSubWindow()解説

QMdiArea::activateNextSubWindow()は、Qt WidgetsライブラリにおけるQMdiAreaクラスの関数です。これは、複数の子ウィンドウを管理するMDIエリアにおいて、次のアクティブな子ウィンドウにフォーカスを切り替えるための関数です。

機能

この関数は、以下の機能を提供します。

• 次のアクティブな子ウィンドウにフォーカスを移動します。
• フォーカス移動は、子ウィンドウリストの順序に基づいて行われます。
• アクティブな子ウィンドウが存在しない場合は、最初の子ウィンドウにフォーカスが移動します。**

コード例

#include <QtWidgets/QApplication>
#include <QtWidgets/QMdiArea>
#include <QtWidgets/QMdiSubWindow>

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

  // MDIエリアを作成
  QMdiArea mdiArea;

  // 3つのサブウィンドウを作成
  for (int i = 0; i < 3; ++i) {
    QMdiSubWindow *subWindow = new QMdiSubWindow(&mdiArea);
    subWindow->setWindowTitle(QString("サブウィンドウ %1").arg(i + 1));
    subWindow->show();
  }

  // 最初のサブウィンドウをアクティブにする
  mdiArea.activateNextSubWindow();

  // ボタンクリック時に次のサブウィンドウにフォーカスを移動
  QPushButton button("次のサブウィンドウに移動");
  button.connect(&button, &QPushButton::clicked, &mdiArea, &QMdiArea::activateNextSubWindow);

  mdiArea.show();

  return app.exec();
}

補足

• QMdiArea::activateNextSubWindow()は、Qt::WA_ mdiArea::ActivationHistoryウィンドウフラグが設定されている場合、最近アクティブだった子ウィンドウにフォーカスを移動します。
• QMdiArea::activatePreviousSubWindow()を使用して、前のアクティブな子ウィンドウにフォーカスを移動することもできます。
• QMdiArea::setActiveSubWindow()を使用して、特定の子ウィンドウをアクティブにすることもできます。

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

#include <QtWidgets/QApplication>
#include <QtWidgets/QMdiArea>
#include <QtWidgets/QMdiSubWindow>

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

  // MDIエリアを作成
  QMdiArea mdiArea;

  // 3つのサブウィンドウを作成
  for (int i = 0; i < 3; ++i) {
    QMdiSubWindow *subWindow = new QMdiSubWindow(&mdiArea);
    subWindow->setWindowTitle(QString("サブウィンドウ %1").arg(i + 1));
    subWindow->show();
  }

  // 最初のサブウィンドウをアクティブにする
  mdiArea.activateNextSubWindow();

  // ボタンクリック時に次のサブウィンドウにフォーカスを移動
  QPushButton button("次のサブウィンドウに移動");
  button.connect(&button, &QPushButton::clicked, &mdiArea, &QMdiArea::activateNextSubWindow);

  mdiArea.show();

  return app.exec();
}

最近アクティブだったサブウィンドウにフォーカスを移動する

#include <QtWidgets/QApplication>
#include <QtWidgets/QMdiArea>
#include <QtWidgets/QMdiSubWindow>

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

  // MDIエリアを作成
  QMdiArea mdiArea;

  // 3つのサブウィンドウを作成
  for (int i = 0; i < 3; ++i) {
    QMdiSubWindow *subWindow = new QMdiSubWindow(&mdiArea);
    subWindow->setWindowTitle(QString("サブウィンドウ %1").arg(i + 1));
    subWindow->show();
  }

  // 最初のサブウィンドウをアクティブにする
  mdiArea.activateNextSubWindow();

  // サブウィンドウ2をアクティブにする
  mdiArea.setActiveSubWindow(mdiArea.subWindowList().at(1));

  // ボタンクリック時に最近アクティブだったサブウィンドウにフォーカスを移動
  QPushButton button("最近アクティブだったサブウィンドウに移動");
  button.connect(&button, &QPushButton::clicked, &mdiArea, &QMdiArea::activateNextSubWindow);

  mdiArea.show();

  return app.exec();
}

特定の子ウィンドウにフォーカスを移動する

#include <QtWidgets/QApplication>
#include <QtWidgets/QMdiArea>
#include <QtWidgets/QMdiSubWindow>

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

  // MDIエリアを作成
  QMdiArea mdiArea;

  // 3つのサブウィンドウを作成
  for (int i = 0; i < 3; ++i) {
    QMdiSubWindow *subWindow = new QMdiSubWindow(&mdiArea);
    subWindow->setWindowTitle(QString("サブウィンドウ %1").arg(i + 1));
    subWindow->show();
  }

  // サブウィンドウ2をアクティブにする
  mdiArea.setActiveSubWindow(mdiArea.subWindowList().at(1));

  // ボタンクリック時にサブウィンドウ3にフォーカスを移動
  QPushButton button("サブウィンドウ3に移動");
  button.connect(&button, &QPushButton::clicked, [&mdiArea]() {
    mdiArea.setActiveSubWindow(mdiArea.subWindowList().at(2));
  });

  mdiArea.show();

  return app.exec();
}

これらのサンプルコードは、QMdiArea::activateNextSubWindow()関数のさまざまな使い方を示しています。これらのコードを参考に、ご自身のアプリケーションに合ったコードを作成してください。

QMdiArea::activateNextSubWindow() 以外の方法

サブウィンドウリストを直接操作する

// サブウィンドウリストを取得
QList<QMdiSubWindow *> subWindowList = mdiArea.subWindowList();

// 現在のサブウィンドウのインデックスを取得
int currentIndex = subWindowList.indexOf(mdiArea.activeSubWindow());

// 次のサブウィンドウのインデックスを計算
int nextIndex = (currentIndex + 1) % subWindowList.size();

// 次のサブウィンドウをアクティブにする
mdiArea.setActiveSubWindow(subWindowList.at(nextIndex));

キーボードショートカットを使用する

Qt は、MDI エリアを操作するためのいくつかのキーボードショートカットを提供しています。次のサブウィンドウに移動するには、Ctrl+Tab キーを押します。

カスタムウィジェットを作成する

独自のウィジェットを作成して、次のサブウィンドウに移動する機能を実装することもできます。この方法を使用すると、独自の外観や機能を持つボタンやその他の UI 要素を作成できます。