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)

指定されたarea に、指定されたdockwidget を追加します。

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

指定されたarea にorientation で指定された方向に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()も参照してください 。