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

widget 을 MDI 영역에 새 하위 창으로 추가합니다. windowFlags 이 0이 아닌 경우 위젯에 설정된 플래그를 재정의합니다.

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 * 이벤트).

[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 * 이벤트).

[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 * 이벤트).

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 * 이벤트).

[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 이 참이면 MDI 영역에서 option 이 활성화되고, 그렇지 않으면 비활성화됩니다. 각 옵션의 효과는 AreaOption 을 참조하세요.

AreaOption 및 testOption()도 참조하세요 .

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

다시 구현합니다: QAbstractScrollArea::setupViewport(QWidget *뷰포트).

이 슬롯은 setViewport()이 호출된 후 QAbstractScrollArea 에 의해 호출됩니다. 이 함수를 QMdiArea 의 서브클래스에서 다시 구현하여 새로운 viewport 을 사용하기 전에 초기화하세요.

setViewport()도 참조하세요 .

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

다시 구현합니다: QWidget::showEvent(QShowEvent * 이벤트).

[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(Q타이머이벤트 *이벤트).

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

다시 구현합니다: QAbstractScrollArea::viewportEvent(QEvent * 이벤트).