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 かサブウィンドウの内部ウィジェットでなければならない。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)

再実装：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なら、option がMDIエリアで有効になり、そうでなければ無効になる。各オプションの効果についてはAreaOption を参照のこと。

AreaOption およびtestOption()も参照の こと。

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

再実装：QAbstractScrollArea::setupViewport(QWidget *viewport)。

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

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)。