QMainWindow Class

メンバ関数のドキュメント

[explicit] QMainWindow::QMainWindow(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

指定されたparent と指定されたウィジェットflags を持つ QMainWindow を構築します。

QMainWindow は、Qt::Window フラグを自分で設定するので、常にトップレベル ウィジェットとして作成されます。

[virtual noexcept] QMainWindow::~QMainWindow()

メインウィンドウを破壊する。

void QMainWindow::addDockWidget(Qt::DockWidgetArea area, QDockWidget *dockwidget)

与えられたdockwidget を指定されたarea に追加する。

void QMainWindow::addDockWidget(Qt::DockWidgetArea area, QDockWidget *dockwidget, Qt::Orientation orientation)

orientation で指定された方向に、与えられたarea にdockwidget を追加する。

void QMainWindow::addToolBar(Qt::ToolBarArea area, QToolBar *toolbar)

このメインウィンドウの指定されたarea にtoolbar を追加する。toolbar は現在のツールバーブロックの末尾（つまり行）に配置される。メイン・ウィンドウがすでにtoolbar を管理している場合は、ツールバーをarea に移動するだけです。

insertToolBar()、addToolBarBreak()、insertToolBarBreak()も参照のこと 。

void QMainWindow::addToolBar(QToolBar *toolbar)

これはオーバーロードされた関数です。

addToolBar(Qt::TopToolBarArea,toolbar) を呼び出すのと同等です。

QToolBar *QMainWindow::addToolBar(const QString &title)

これはオーバーロードされた関数です。

QToolBar オブジェクトを作成し、そのウィンドウ・タイトルをtitle に設定し、それを一番上のツールバー領域に挿入します。

setWindowTitle()も参照してください 。

void QMainWindow::addToolBarBreak(Qt::ToolBarArea area = Qt::TopToolBarArea)

与えられたarea に、存在する他のすべてのオブジェクトの後に、ツールバーの区切りを追加する。

QWidget *QMainWindow::centralWidget() const

メインウィンドウの中心ウィジェットを返します。中心ウィジェットが設定されていない場合、この関数はnullptr を返す。

setCentralWidget()も参照 。

[override virtual protected] void QMainWindow::contextMenuEvent(QContextMenuEvent *event)

再実装：QWidget::contextMenuEvent(QContextMenuEvent *event)。

Qt::DockWidgetArea QMainWindow::corner(Qt::Corner corner) const

指定されたcorner を占めるドックウィジェット領域を返します。

setCorner()も参照してください 。

[virtual] QMenu *QMainWindow::createPopupMenu()

メインウィンドウに存在するツールバーとドックウィジェットのチェック可能なエントリを含むポップアップメニューを返す。ツールバーとドックウィジェットが存在しない場合、この関数はnullptr を返します。

デフォルトでは、この関数はユーザがコンテキストメニューをアクティブにしたときにメイン・ウィンドウから呼び出されます。通常はツールバーやドック・ウィジェットを右クリックします。

カスタムポップアップメニューを作成したい場合は、この関数を再実装し、新しく作成したポップアップメニューを返してください。ポップアップ・メニューの所有権は呼び出し元に移ります。

addDockWidget()、addToolBar()、menuBar()も参照してください 。

Qt::DockWidgetArea QMainWindow::dockWidgetArea(QDockWidget *dockwidget) const

dockwidget のQt::DockWidgetArea を返す。dockwidget がメイン・ウィンドウに追加されていない場合、この関数はQt::NoDockWidgetArea を返す。

addDockWidget()、splitDockWidget()、Qt::DockWidgetAreaも参照のこと 。

[override virtual protected] bool QMainWindow::event(QEvent *event)

再実装：QWidget::event(QEvent *event)。

[signal] void QMainWindow::iconSizeChanged(const QSize &iconSize)

このシグナルは、ウィンドウで使用されるアイコンのサイズが変更されたときに発行される。新しいアイコンサイズはiconSize で渡されます。

このシグナルを他のコンポーネントに接続することで、アプリケーションの外観を統一することができます。

setIconSize()も参照 。

void QMainWindow::insertToolBar(QToolBar *before, QToolBar *toolbar)

before ツールバーが占める領域にtoolbar を挿入し、 ツールバーの前に表示されるようにする。例えば、通常の左から右へのレイアウト操作の場合、toolbar は、before で指定されたツールバーの左側、水平なツールバー領域に表示されることを意味する。

insertToolBarBreak （）、addToolBar （）、addToolBarBreak （）も参照の こと。

void QMainWindow::insertToolBarBreak(QToolBar *before)

before で指定したツールバーの前にツールバーの区切りを挿入します。

QMenuBar *QMainWindow::menuBar() const

メインウィンドウのメニューバーを返します。メニュー・バーが存在しない場合、この関数は空のメニュー・バーを作成して返します。

Macアプリケーションのすべてのウィンドウで1つのメニューバーを共有したい場合は、この関数を使って作成しないでください。ここで作成されたメニューバーは、このQMainWindow を親として持つからです。代わりに、親を持たないメニューバーを作成し、それをすべてのMacウィンドウで共有できるようにする必要があります。この方法で親のないメニューバーを作成します：

QMenuBar *menuBar = new QMenuBar(nullptr);

setMenuBar()も参照してください 。

QWidget *QMainWindow::menuWidget() const

メインウィンドウのメニューバーを返します。メニューバーがまだ作成されていない場合、この関数は null を返します。

setMenuWidget()も参照 。

void QMainWindow::removeDockWidget(QDockWidget *dockwidget)

dockwidget をメインウィンドウのレイアウトから削除し、非表示にします。dockwidget は削除されないことに注意してください。

void QMainWindow::removeToolBar(QToolBar *toolbar)

toolbar をメインウィンドウのレイアウトから削除し、非表示にします。toolbar は削除されないことに注意してください。

void QMainWindow::removeToolBarBreak(QToolBar *before)

before で指定されたツールバーの前に挿入されていたツールバーの区切りを削除します。

void QMainWindow::resizeDocks(const QList<QDockWidget *> &docks, const QList<int> &sizes, Qt::Orientation orientation)

リストdocks のドックウィジェットを、リストsizes の対応するサイズにピクセル単位でリサイズします。orientation がQt::Horizontal の場合は幅を調整し、そうでない場合はドックウィジェットの高さを調整します。サイズは、最大サイズと最小サイズが尊重されるように調整され、QMainWindow 自体のサイズは変更されません。追加/不足スペースは、サイズの相対的な重さに従ってウィジェットに分配されます。

例

    resizeDocks({blueWidget, yellowWidget}, {20 , 40}, Qt::Horizontal);

例: 青と黄色のウィジェットが同じレベルにネストされている場合、yellowWidgetがblueWidgetの2倍の大きさになるようにリサイズされます。

いくつかのウィジェットがタブでグループ化されている場合、グループごとに1つのウィジェットだけを指定する必要があります。リストにないウィジェットは、制約を尊重するために変更されるかもしれません。

bool QMainWindow::restoreDockWidget(QDockWidget *dockwidget)

restoreState() のコール後にdockwidget が作成された場合、その状態を復元する。状態が復元された場合はtrue を返し、そうでない場合はfalse を返す。

restoreState() およびsaveState()も参照 。

bool QMainWindow::restoreState(const QByteArray &state, int version = 0)

このメインウィンドウのツールバーとドックウィジェットのstate を復元します。コーナー設定も復元します。version の番号がstate に保存された番号と比較されます。両者が一致しない場合、メインウィンドウの状態は変更されずに、この関数はfalse を返します。それ以外の場合、状態は復元され、この関数はtrue を返します。

QSettings を使用して保存したジオメトリを復元するには、次のようなコードを使用できます：

void MainWindow::readSettings()
{
    QSettings settings("MyCompany", "MyApp");
    restoreGeometry(settings.value("myWidget/geometry").toByteArray());
    restoreState(settings.value("myWidget/windowState").toByteArray());
}

saveState(),QWidget::saveGeometry(),QWidget::restoreGeometry(),restoreDockWidget()も参照のこと 。

QByteArray QMainWindow::saveState(int version = 0) const

メインウィンドウのツールバーとドックウィジェットの現在の状態を保存します。これにはsetCorner() で設定できるコーナー設定も含まれる。version 番号はデータの一部として保存されます。

objectName プロパティは、各QToolBar とQDockWidget を識別するために使用されます。このプロパティは、QToolBar とQDockWidget に追加するごとに一意であることを確認する必要があります。QMainWindow

保存された状態を復元するには、戻り値とversion 番号をrestoreState() に渡します。

ウィンドウが閉じたときにジオメトリを保存するには、このように close イベントを実装します：

void MyMainWindow::closeEvent(QCloseEvent *event)
{
    QSettings settings("MyCompany", "MyApp");
    settings.setValue("geometry", saveGeometry());
    settings.setValue("windowState", saveState());
    QMainWindow::closeEvent(event);
}

restoreState()、QWidget::saveGeometry()、QWidget::restoreGeometry()も参照してください 。

void QMainWindow::setCentralWidget(QWidget *widget)

与えられたwidget をメインウィンドウの中心ウィジェットに設定する。

注意:QMainWindow はwidget ポインタの所有権を持ち、適切なタイミングで削除します。

centralWidget()も参照してください 。

void QMainWindow::setCorner(Qt::Corner corner, Qt::DockWidgetArea area)

与えられたドックウィジェットarea を、指定されたcorner を占有するように設定します。

corner()も参照してください 。

void QMainWindow::setMenuBar(QMenuBar *menuBar)

メインウィンドウのメニューバーをmenuBar に設定する。

注:QMainWindow はmenuBar ポインタの所有権を持ち、適切なタイミングで削除する。

menuBar()も参照のこと 。

void QMainWindow::setMenuWidget(QWidget *menuBar)

メイン・ウィンドウのメニュー・バーをmenuBar に設定する。

QMainWindow は ポインタの所有権を取得し、適切なタイミングで削除する。menuBar

menuWidget()も参照のこと 。

void QMainWindow::setStatusBar(QStatusBar *statusbar)

メインウィンドウのステータスバーをstatusbar に設定する。

ステータス・バーをnullptr に設定すると、メイン・ウィンドウから削除される。QMainWindow はstatusbar ポインタの所有権を持ち、適切なタイミングで削除されることに注意。

statusBar()も参照のこと 。

void QMainWindow::setTabPosition(Qt::DockWidgetAreas areas, QTabWidget::TabPosition tabPosition)

与えられたドックウィジェットareas のタブ位置を、指定されたtabPosition に設定します。デフォルトでは、すべてのドックエリアはタブを一番下に表示します。

tabPosition() およびsetTabShape()も参照 ください。

void QMainWindow::splitDockWidget(QDockWidget *first, QDockWidget *second, Qt::Orientation orientation)

first ドックウィジェットがカバーする空間を2つに分割し、first ドックウィジェットを最初の部分に移動し、second ドックウィジェットを2番目の部分に移動する。

orientation 、スペースの分割方法を指定します：Qt::Horizontal 。分割すると、2つ目のドックウィジェットは1つ目のドックウィジェットの右に配置され、Qt::Vertical 。分割すると、2つ目のドックウィジェットは1つ目のドックウィジェットの下に配置されます。

注意:first が現在タブのドック領域にある場合、second はfirst の隣ではなく、新しいタブとして追加されます。 これはひとつのタブにはひとつのドックウィジェットしか入れられないためです。

注意:Qt::LayoutDirection は分割された2つの部分のドックウィジェットの順番に影響します。右から左へのレイアウトを有効にすると、ドックウィジェットの配置は逆になります。

tabifyDockWidget(),addDockWidget(),removeDockWidget()も参照してください 。

QStatusBar *QMainWindow::statusBar() const

メイン・ウィンドウのステータス・バーを返します。ステータス・バーが存在しない場合、この関数は空のステータス・バーを作成し、返す。

setStatusBar()も参照 。

QTabWidget::TabPosition QMainWindow::tabPosition(Qt::DockWidgetArea area) const

area のタブ位置を返します。

setTabPosition() およびtabShape()も参照 。

[signal] void QMainWindow::tabifiedDockWidgetActivated(QDockWidget *dockWidget)

このシグナルは、タブを選択してタブ化されたドックウィジェットがアクティブになったときに発せられます。アクティブ化されたドックウィジェットはdockWidget で渡されます。

tabifyDockWidget() およびtabifiedDockWidgets()も参照してください 。

QList<QDockWidget *> QMainWindow::tabifiedDockWidgets(QDockWidget *dockwidget) const

dockwidget とともにタブ化されたドックウィジェットを返します。

tabifyDockWidget()も参照 。

void QMainWindow::tabifyDockWidget(QDockWidget *first, QDockWidget *second)

second ドックウィジェットをfirst ドックウィジェットの上に移動し、メインウィンドウにタブ付きドックエリアを作る。

tabifiedDockWidgets()も参照してください 。

QWidget *QMainWindow::takeCentralWidget()

メインウィンドウから中央のウィジェットを削除します。

削除されたウィジェットの所有権は呼び出し元に渡されます。

Qt::ToolBarArea QMainWindow::toolBarArea(const QToolBar *toolbar) const

toolbar のQt::ToolBarArea を返す。toolbar がメイン・ウィンドウに追加されていない場合、この関数はQt::NoToolBarArea を返す。

addToolBar()、addToolBarBreak()、Qt::ToolBarAreaも参照のこと 。

bool QMainWindow::toolBarBreak(QToolBar *toolbar) const

toolbar の前にツールバーの区切りがあるかどうかを返す。

addToolBarBreak() およびinsertToolBarBreak()も参照 。

[signal] void QMainWindow::toolButtonStyleChanged(Qt::ToolButtonStyle toolButtonStyle)

このシグナルは、ウィンドウのツールボタンに使用されるスタイルが変更されたときに発行されます。新しいスタイルはtoolButtonStyle で渡されます。

このシグナルを他のコンポーネントに接続することで、アプリケーションの外観を統一することができます。

setToolButtonStyle()も参照してください 。