QMdiArea Class

メンバ関数ドキュメント

QMdiArea::QMdiArea(QWidget *parent = nullptr)

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

再リプルメント: (QObject *watched, QEvent *event)：QAbstractScrollArea::minimumSizeHint() const.

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

再リプルメント: (QOject *watched, QEvent *event)：QAbstractScrollArea::paintEvent(QPaintEvent *event)。

void QMdiArea::removeSubWindow(QWidget *widget)

MDI 領域からwidget を削除します。widget はQMdiSubWindow かサブウィンドウの内部ウィジェットでなければなりません。QMdiArea によってwidget が実際に削除されることはない。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)

Reimplements: (QResizeEvent *event)：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 が真の場合、option は MDI 領域で有効になり、そうでない場合は無効になる。各オプションの効果については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)を再実装します。