QMdiArea Class

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

QMdiArea::QMdiArea(QWidget *parent = nullptr)

空のMDI領域を作成します。parent は、QWidget のコンストラクタに渡されます。

[virtual noexcept] QMdiArea::~QMdiArea()

MDI領域を削除します。

[slot] void QMdiArea::activateNextSubWindow()

子ウィンドウのリストにある別のウィンドウにキーボードフォーカスを移します。アクティブになるウィンドウは、現在のactivation order によって決定される次のウィンドウとなります。

activatePreviousSubWindow() およびQMdiArea::WindowOrderも参照してください 。

[slot] void QMdiArea::activatePreviousSubWindow()

子ウィンドウのリストにある別のウィンドウにキーボードフォーカスを移します。アクティブになるウィンドウは、現在のactivation order によって決定される直前のウィンドウとなります。

activateNextSubWindow() およびQMdiArea::WindowOrderも参照してください 。

QMdiSubWindow *QMdiArea::activeSubWindow() const

現在アクティブなサブウィンドウへのポインタを返します。現在アクティブなウィンドウがない場合は、nullptr が返されます。

サブウィンドウは、ウィンドウの状態に関してはトップレベルウィンドウとして扱われます。つまり、MDI 領域外のウィジェットがアクティブなウィンドウである場合、どのサブウィンドウもアクティブにはなりません。なお、MDI 領域を含むウィンドウ内のウィジェットがフォーカスを獲得すると、そのウィンドウがアクティブになることに注意してください。

setActiveSubWindow() およびQt::WindowStateも参照してください 。

QMdiSubWindow *QMdiArea::addSubWindow(QWidget *widget, Qt::WindowFlags windowFlags = Qt::WindowFlags())

MDI領域に「widget 」という新しいサブウィンドウを追加します。windowFlags がゼロ以外の場合、ウィジェットに設定されているフラグよりも優先されます。

widget は、QMdiSubWindow または別のQWidget のいずれかです（後者の場合、MDI エリアはサブウィンドウを作成し、widget を内部ウィジェットとして設定します）。

QMdiArea mdiArea;
QMdiSubWindow *subWindow1 = new QMdiSubWindow;
subWindow1->setWidget(internalWidget1);
subWindow1->setAttribute(Qt::WA_DeleteOnClose);
mdiArea.addSubWindow(subWindow1);

QMdiSubWindow *subWindow2 =
    mdiArea.addSubWindow(internalWidget2);

独自のサブウィンドウを作成する場合、MDI エリア内でウィンドウが閉じられた際にそのウィンドウを削除したい場合は、Qt::WA_DeleteOnClose ウィジェット属性を設定する必要があります。設定しない場合、ウィンドウは非表示になり、MDI エリアは次のサブウィンドウをアクティブにしません。

MDI 領域に追加された `QMdiSubWindow ` を返します。

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

[slot] void QMdiArea::cascadeSubWindows()

すべての子ウィンドウをカスケード配置にします。

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

[override virtual protected] void QMdiArea::childEvent(QChildEvent *childEvent)

QObject::childEvent(QChildEvent *event) を再実装します。

[slot] void QMdiArea::closeActiveSubWindow()

アクティブなサブウィンドウを閉じます。

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

[slot] void QMdiArea::closeAllSubWindows()

各ウィンドウにQCloseEvent を送信して、すべてのサブウィンドウを閉じます。サブウィンドウが閉じられる前に、そのサブウィンドウからsubWindowActivated()シグナルを受信する場合があります（別のサブウィンドウが閉じられている際に、MDI領域が当該サブウィンドウをアクティブにした場合など）。

閉じるイベントを無視するサブウィンドウは、開いたままになります。

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

QMdiSubWindow *QMdiArea::currentSubWindow() const

現在のサブウィンドウへのポインタを返します。現在のサブウィンドウがない場合は、nullptr を返します。

QMdiArea を含むQApplication がアクティブな場合、この関数はactiveSubWindow() と同じ値を返します。

activeSubWindow() およびQApplication::activeWindow()も参照してください 。

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

QAbstractScrollArea::event(QEvent *event) を再実装します。

[override virtual protected] bool QMdiArea::eventFilter(QObject *object, QEvent *event)

QObject::eventFilter(QObject *watched, QEvent *event) を再実装します。

[override virtual] QSize QMdiArea::minimumSizeHint() const

QAbstractScrollArea::minimumSizeHint() const を再実装します。

[override virtual protected] void QMdiArea::paintEvent(QPaintEvent *paintEvent)

QAbstractScrollArea::paintEvent(QPaintEvent *event) を再実装します。

void QMdiArea::removeSubWindow(QWidget *widget)

MDI領域からwidget を削除します。widget は、QMdiSubWindow 、またはサブウィンドウの内部ウィジェットである必要があります。注：widget は、QMdiArea によって実際には削除されることはありません。QMdiSubWindow が渡された場合、その親はnullptr に設定され、削除されます。一方、内部ウィジェットが渡された場合、子ウィジェットはnullptr に設定され、QMdiSubWindow は削除されません。

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

[override virtual protected] void QMdiArea::resizeEvent(QResizeEvent *resizeEvent)

QAbstractScrollArea::resizeEvent(QResizeEvent *event) を再実装します。

[override virtual protected] void QMdiArea::scrollContentsBy(int dx, int dy)

QAbstractScrollArea::scrollContentsBy(int dx, int dy) を再実装します。

[slot] void QMdiArea::setActiveSubWindow(QMdiSubWindow *window)

サブウィンドウ `window` をアクティブにします。window が `nullptr` の場合、現在アクティブなウィンドウはすべて非アクティブになります。

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

void QMdiArea::setOption(QMdiArea::AreaOption option, bool on = true)

on が true の場合、MDI 領域で「option 」が有効になります。それ以外の場合は無効になります。各オプションの効果については、AreaOption を参照してください。

AreaOption およびtestOption()も参照してください 。

[override virtual protected slot] void QMdiArea::setupViewport(QWidget *viewport)

QAbstractScrollArea::setupViewport(QWidget *viewport) を再実装します。

このスロットは、setViewport()が呼び出された後、QAbstractScrollArea によって呼び出されます。QMdiArea のサブクラスでこの関数を再実装し、新しいviewport が使用される前に初期化してください。

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

[override virtual protected] void QMdiArea::showEvent(QShowEvent *showEvent)

QWidget::showEvent(QShowEvent *event) を再実装します。

[override virtual] QSize QMdiArea::sizeHint() const

QAbstractScrollArea::sizeHint() const を再実装します。

[signal] void QMdiArea::subWindowActivated(QMdiSubWindow *window)

QMdiArea window がアクティブになった後に、このシグナルを発行します。 が の場合、 は直前に最後のアクティブなウィンドウを非アクティブにし、ワークスペース上にアクティブなウィンドウが存在しません。window nullptr QMdiArea

QMdiArea::activeSubWindow()も参照してください 。

QList<QMdiSubWindow *> QMdiArea::subWindowList(QMdiArea::WindowOrder order = CreationOrder) const

MDI 領域内のすべてのサブウィンドウのリストを返します。order がCreationOrder （デフォルト）の場合、ウィンドウはワークスペースに挿入された順序でソートされます。order がStackingOrder の場合、ウィンドウはスタック順にリストされ、最上部のウィンドウがリストの最後の項目となります。order がActivationHistoryOrder の場合、ウィンドウは直近のアクティブ化履歴に基づいてリストされます。

WindowOrderも参照してください 。

bool QMdiArea::testOption(QMdiArea::AreaOption option) const

option が有効な場合はtrue を返し、そうでない場合はfalse を返します。

AreaOption およびsetOption()も参照してください 。

[slot] void QMdiArea::tileSubWindows()

すべての子ウィンドウをタイル状に配置します。

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

[override virtual protected] void QMdiArea::timerEvent(QTimerEvent *timerEvent)

QObject::timerEvent(QTimerEvent *event) の再実装です。

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

QAbstractScrollArea::viewportEvent(QEvent *event) を再実装しています。