Класс QMdiArea

Виджет QMdiArea предоставляет область для отображения окон MDI. Подробнее...

Этот класс был представлен в Qt 4.3.

• Список всех членов, включая унаследованные

Типы публичного доступа

Свойства

Открытые функции

Переопределённые открытые функции

Открытые слоты

Сигналы

Переопределённые защищённые функции

Защищённые слоты

Подробное описание

QMdiArea работает, по сути, как менеджер окон для окон MDI. Например, он отображает управляемые им окна на себе и располагает их в каскадной или мозаичной структуре. QMdiArea обычно используется как центральный виджет в QMainWindow для создания MDI-приложений, но также может быть размещён в любом макете. Следующий код добавляет область в главное окно:

    QMainWindow *mainWindow = new QMainWindow;
    mainWindow->setCentralWidget(mdiArea);

В отличие от менеджеров окон верхнего уровня, все флаги окон (Qt::WindowFlags) поддерживаются QMdiArea, если эти флаги поддерживаются текущим стилем виджета. Если определённый флаг не поддерживается стилем (например, WindowShadeButtonHint), вы по-прежнему можете затемнить окно с помощью showShaded().

Подокна в QMdiArea являются экземплярами QMdiSubWindow. Они добавляются в область MDI с помощью addSubWindow(). Обычно в эту функцию передаётся QWidget, который устанавливается в качестве внутреннего виджета, но также можно передать QMdiSubWindow напрямую. Класс наследует от QWidget, и при программировании можно использовать тот же API, что и для обычного окна верхнего уровня. QMdiSubWindow также имеет поведение, специфичное для окон MDI. Дополнительные сведения см. в описании класса QMdiSubWindow.

Под­окно становится активным, когда получает фокус клавиатуры или когда вызывается setFocus(). Пользователь активирует окно, перемещая фокус обычным способом. Область MDI испускает сигнал subWindowActivated() при изменении активного окна, а функция activeSubWindow() возвращает активное под­окно.

Вспомогательная функция subWindowList() возвращает список всех под­окон. Например, эта информация может использоваться в всплывающем меню, содержащем список окон.

Под­окна упорядочиваются по текущему значению WindowOrder. Это используется для subWindowList(), а также для activateNextSubWindow() и activatePreviousSubWindow(). Кроме того, оно используется при каскадном или мозаичном расположении окон с помощью cascadeSubWindows() и tileSubWindows().

QMdiArea предоставляет две встроенные стратегии макета для под­окон: cascadeSubWindows() и tileSubWindows(). Обе являются слотами и легко подключаются к пунктам меню.

Примечание: Свойство полосы прокрутки по умолчанию для QMdiArea равно Qt::ScrollBarAlwaysOff.

См. также QMdiSubWindow.

Документация по типам членов

перечисление QMdiArea::AreaOptionflags QMdiArea::AreaOptions

Это перечисление описывает параметры, которые настраивают поведение QMdiArea.

Тип AreaOptions является псевдонимом для QFlags<AreaOption>. Он хранит логическое ИЛИ сочетание значений AreaOption.

перечисление QMdiArea::ViewMode

Это перечисление описывает режим отображения области; т. е. как будут отображаться под­окна.

Это перечисление было введено или изменено в Qt 4.4.

См. также setViewMode().

перечисление QMdiArea::WindowOrder

Указывает критерии для упорядочивания списка дочерних окон, возвращаемых функцией subWindowList(). Функции cascadeSubWindows() и tileSubWindows() следуют этому порядку при расположении окон.

См. также subWindowList().

Документация функций-членов

QMdiArea::QMdiArea(QWidget *parent = nullptr)

Создает пустую область MDI. parent передается конструктору QWidget.

void QMdiArea::activateNextSubWindow()

Передает фокус клавиатуры другому окну в списке дочерних окон. Активированное окно будет следующим, определенным текущим порядком активации activation order.

См. также activatePreviousSubWindow() и QMdiArea::WindowOrder.

void QMdiArea::activatePreviousSubWindow()

Передает фокус клавиатуры другому окну в списке дочерних окон. Активированное окно будет предыдущим, определенным текущим порядком активации activation order.

См. также activateNextSubWindow() и QMdiArea::WindowOrder.

void QMdiArea::cascadeSubWindows()

Располагает все дочерние окна в виде каскада.

См. также tileSubWindows().

void QMdiArea::closeActiveSubWindow()

Закрывает активное дочернее окно.

См. также closeAllSubWindows().

void QMdiArea::closeAllSubWindows()

Закрывает все дочерние окна, отправляя событие QCloseEvent каждому окну. Вы можете получить сигналы subWindowActivated() от дочерних окон до их закрытия (если область MDI активирует дочернее окно во время закрытия другого).

Дочерние окна, игнорирующие событие закрытия, останутся открытыми.

См. также closeActiveSubWindow().

void QMdiArea::setActiveSubWindow(QMdiSubWindow *window)

Активирует дочернее окно window. Если window является nullptr, любое текущее активное окно деактивируется.

См. также activeSubWindow().

void QMdiArea::setupViewport(QWidget *viewport)

Переопределяет: QAbstractScrollArea::setupViewport(QWidget *viewport).

Этот слот вызывается QAbstractScrollArea после вызова setViewport(). Переопределите эту функцию в подклассе QMdiArea, чтобы инициализировать новое viewport перед его использованием.

См. также setViewport().

void QMdiArea::subWindowActivated(QMdiSubWindow *window)

QMdiArea посылает этот сигнал после активации window. Когда window равен 0, QMdiArea только что деактивировал последнее активное окно, и нет активных окон в рабочей области.

См. также QMdiArea::activeSubWindow().

[slot] void QMdiArea::tileSubWindows()

Располагает все дочерние окна в виде плитки.

См. также cascadeSubWindows().

[virtual] QMdiArea::~QMdiArea()

Удаляет область MDI.

QMdiSubWindow *QMdiArea::activeSubWindow() const

Возвращает указатель на текущее активное подокно. Если активное окно отсутствует, возвращается nullptr.

Подвиджеты рассматриваются как окна верхнего уровня относительно состояния окна, т.е. если активным окном является виджет вне области MDI, ни одно подвиджет не будет активным. Обратите внимание, что если виджет в окне, в котором находится область MDI, получает фокус, окно будет активировано.

См. также setActiveSubWindow() и Qt::WindowState.

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

Добавляет widget в качестве нового подвиджета в область MDI. Если windowFlags ненулевые, они переопределят флаги, установленные для виджета.

widget может быть либо QMdiSubWindow, либо другим QWidget (в этом случае область MDI создаст подвиджет и установит widget в качестве внутреннего виджета).

Примечание: После добавления подвиджета его родителем станет viewport widget QMdiArea.

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

    QMdiSubWindow *subWindow2 =
        mdiArea.addSubWindow(internalWidget2);

При создании собственного подвиджета необходимо установить атрибут виджета Qt::WA_DeleteOnClose, если вы хотите, чтобы окно удалялось при закрытии в области MDI. В противном случае окно будет скрыто, и область MDI не активирует следующее подвиджет.

Возвращает QMdiSubWindow, добавленный в область MDI.

См. также removeSubWindow().

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

Переопределяет: QObject::childEvent(QChildEvent *event).

QMdiSubWindow *QMdiArea::currentSubWindow() const

Возвращает указатель на текущее подвиджет, или nullptr если текущего подвиджета нет.

Эта функция вернёт то же, что и activeSubWindow(), если QApplication, содержащая QMdiArea, активна.

См. также 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)

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

Удаляет widget из области MDI. 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).

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

Если on равно true, option включен в области MDI; в противном случае он выключен. См. AreaOption для эффекта каждого параметра.

См. также AreaOption и testOption().

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

Переопределяет: QWidget::showEvent(QShowEvent *event).

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

Переопределяет: QAbstractScrollArea::sizeHint() const.

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

Возвращает список всех подвиджетов в области MDI. Если order равен CreationOrder (по умолчанию), окна сортируются в порядке их вставки в рабочую область. Если order равен StackingOrder, окна перечисляются в порядке наложения, причём верхнее окно — последний элемент списка. Если order равен ActivationHistoryOrder, окна перечисляются в соответствии с их недавней историей активации.

См. также WindowOrder.

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

Возвращает true если option включено; в противном случае возвращает false.

См. также AreaOption и setOption().

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

Переопределяет: QObject::timerEvent(QTimerEvent *event).

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

Переопределяет: QAbstractScrollArea::viewportEvent(QEvent *event).