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)

toolbar を、before ツールバーが占める領域に挿入し、その前に表示されるようにします。たとえば、通常の左から右へのレイアウト操作では、これにより、水平ツールバー領域において、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 の隣ではなく、新しいタブとして追加されます。これは、1つのタブに格納できるドックウィジェットが1つだけであるためです。

注：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 のドックウィジェットの上に移動させ、first の現在の位置にタブ付きドック領域を作成します。

この関数を呼び出す前に、両方のドックウィジェットが `addDockWidget()` を使用してメインウィンドウに追加されている必要があり、いずれのウィジェットもすでにタブ化されてはいけません。

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

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()も参照してください 。