Класс QMdiArea

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

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

Типы

Свойства

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

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

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

Сигналы

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

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

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

Функции 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.

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

enum QMdiArea::AreaOptionflags QMdiArea::AreaOptions

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

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

enum QMdiArea::ViewMode

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

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

enum QMdiArea::WindowOrder

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

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

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

QMdiArea::QMdiArea(QWidget *parent = nullptr)

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

[slot] void QMdiArea::activateNextSubWindow()

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

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

[slot] void QMdiArea::activatePreviousSubWindow()

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

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

[slot] void QMdiArea::cascadeSubWindows()

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

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

[slot] void QMdiArea::closeActiveSubWindow()

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

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

[slot] void QMdiArea::closeAllSubWindows()

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

ПодОкна, которые игнорируют событие закрытия, останутся открытыми.

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

[slot] void QMdiArea::setActiveSubWindow(QMdiSubWindow *window)

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

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

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

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

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

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

[signal] void QMdiArea::subWindowActivated(QMdiSubWindow *window)

QMdiArea излучает этот сигнал после активации window. Когда window nullptr, 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 области 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)

Переопределяет: 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)

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