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 ’ 값이 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 *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인 경우, 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)를 재구현합니다.