Класс QMdiSubWindow

Класс QMdiSubWindow предоставляет класс подокна для QMdiArea. Подробнее...

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

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

Общедоступные типы

Свойства

• keyboardPageStep : int
• keyboardSingleStep : int

Общедоступные функции

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

Общедоступные слоты

Сигналы

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

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

QMdiSubWindow представляет собой окно верхнего уровня в QMdiArea и состоит из строки заголовка с декорациями окна, внутреннего виджета и (в зависимости от текущего стиля) рамки окна и маркёра размера. QMdiSubWindow имеет собственную структуру макета, состоящую из строки заголовка и центральной области для внутреннего виджета.

Наиболее распространённый способ создания QMdiSubWindow — вызов QMdiArea::addSubWindow() с внутренним виджетом в качестве аргумента. Вы также можете создать подокно самостоятельно и установить внутренний виджет, вызвав setWidget().

Для программирования с под окнами используется тот же API, что и для обычных окон верхнего уровня (например, можно вызывать функции, такие как show(), hide(), showMaximized() и setWindowTitle()).

Обработка под окон

QMdiSubWindow также поддерживает поведение, специфичное для под окон в области MDI.

По умолчанию каждый QMdiSubWindow виден внутри области просмотра MDI при перемещении, но также можно указать прозрачное поведение перемещения и изменения размера окна, где только контур подокна обновляется во время этих операций. Функция setOption() используется для включения этого поведения.

Функция isShaded() определяет, является ли подокно в настоящее время затемнённым (т.е. окно свернуто так, что видна только строка заголовка). Для перехода в режим затемнения вызовите showShaded(). QMdiSubWindow излучает сигнал windowStateChanged(), всякий раз, когда состояние окна изменяется (например, когда окно сворачивается или восстанавливается). Он также излучает aboutToActivate() перед его активацией.

В режиме взаимодействия с клавиатурой окна перемещаются и изменяют размер с помощью клавиатуры. Вы можете перейти в этот режим через системное меню окна. Свойства keyboardSingleStep и keyboardPageStep управляют расстоянием, на которое перемещается или изменяется размер виджета для каждого события нажатия клавиши. При нажатой клавише Shift используется шаг страницы; в противном случае используется шаг.

Вы также можете изменить активное окно с помощью клавиатуры. Нажав клавиши Control и Tab одновременно, будет активировано следующее (используя текущий WindowOrder) подокно. Нажав клавиши Control, Shift и Tab, вы активируете предыдущее окно. Это эквивалентно вызову activateNextSubWindow() и activatePreviousSubWindow(). Обратите внимание, что эти сочетания клавиш переопределяют глобальные сочетания клавиш, но не сочетания клавиш QMdiArea.

См. также QMdiArea.

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

enum QMdiSubWindow::SubWindowOptionflags QMdiSubWindow::SubWindowOptions

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

Тип SubWindowOptions — это typedef для QFlags<SubWindowOption>. Он хранит комбинацию значений SubWindowOption через операцию OR.

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

QMdiSubWindow::QMdiSubWindow(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

Создаёт новый виджет QMdiSubWindow. Аргументы parent и flags передаются в конструктор QWidget.

Вместо использования addSubWindow(), также можно просто использовать setParent(), когда вы добавляете подокно в QMdiArea.

Обратите внимание, что только QMdiSubWindow могут быть установлены в качестве дочерних элементов QMdiArea; вы не можете, например, написать:

//bad code
QMdiArea mdiArea;
QTextEdit editor(&mdiArea); // invalid child widget

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

[signal] void QMdiSubWindow::aboutToActivate()

QMdiSubWindow излучает этот сигнал непосредственно перед тем, как он активируется. После активации подокна, QMdiArea, управляющая подокном, также излучит сигнал subWindowActivated().

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

[slot] void QMdiSubWindow::showShaded()

Вызов этой функции переводит подокно в режим затемнения. Когда подокно затемнено, видна только строка заголовка.

Хотя затемнение не поддерживается всеми стилями, эта функция по-прежнему отобразит подокно как затемнённое независимо от того, поддерживается ли функция затемнения. Однако при использовании со стилями без поддержки затемнения пользователь не сможет вернуться из режима затемнения через пользовательский интерфейс (например, через кнопку затемнения в строке заголовка).

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

[slot] void QMdiSubWindow::showSystemMenu()

Отображает системное меню под значком системного меню в строке заголовка.

См. также setSystemMenu() и systemMenu().

[signal] void QMdiSubWindow::windowStateChanged(Qt::WindowStates oldState, Qt::WindowStates newState)

QMdiSubWindow излучает этот сигнал после изменения состояния окна. oldState — состояние окна до изменения, а newState — новое текущее состояние.

[virtual] QMdiSubWindow::~QMdiSubWindow()

Уничтожает подокно.

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

[override virtual protected] void QMdiSubWindow::changeEvent(QEvent *changeEvent)

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

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

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

[override virtual protected] void QMdiSubWindow::closeEvent(QCloseEvent *closeEvent)

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

[override virtual protected] void QMdiSubWindow::contextMenuEvent(QContextMenuEvent *contextMenuEvent)

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

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

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

[override virtual protected] bool QMdiSubWindow::eventFilter(QObject *object, QEvent *event)

Переопределяет: QObject::eventFilter(QObject *watched, QEvent *event).

[override virtual protected] void QMdiSubWindow::focusInEvent(QFocusEvent *focusInEvent)

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

[override virtual protected] void QMdiSubWindow::focusOutEvent(QFocusEvent *focusOutEvent)

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

[override virtual protected] void QMdiSubWindow::hideEvent(QHideEvent *hideEvent)

Реализует: QWidget::hideEvent(QHideEvent *event).

bool QMdiSubWindow::isShaded() const

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

Окно затеняется, если оно свернуто так, что видна только строка заголовка.

[override virtual protected] void QMdiSubWindow::keyPressEvent(QKeyEvent *keyEvent)

Реализует: QWidget::keyPressEvent(QKeyEvent *event).

[override virtual protected] void QMdiSubWindow::leaveEvent(QEvent *leaveEvent)

Реализует: QWidget::leaveEvent(QEvent *event).

QMdiArea *QMdiSubWindow::mdiArea() const

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

Эта функция была добавлена в Qt 4.4.

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

[override virtual] QSize QMdiSubWindow::minimumSizeHint() const

Реализует функцию доступа к свойству: QWidget::minimumSizeHint.

[override virtual protected] void QMdiSubWindow::mouseDoubleClickEvent(QMouseEvent *mouseEvent)

Реализует: QWidget::mouseDoubleClickEvent(QMouseEvent *event).

[override virtual protected] void QMdiSubWindow::mouseMoveEvent(QMouseEvent *mouseEvent)

Реализует: QWidget::mouseMoveEvent(QMouseEvent *event).

[override virtual protected] void QMdiSubWindow::mousePressEvent(QMouseEvent *mouseEvent)

Реализует: QWidget::mousePressEvent(QMouseEvent *event).

[override virtual protected] void QMdiSubWindow::mouseReleaseEvent(QMouseEvent *mouseEvent)

Реализует: QWidget::mouseReleaseEvent(QMouseEvent *event).

[override virtual protected] void QMdiSubWindow::moveEvent(QMoveEvent *moveEvent)

Реализует: QWidget::moveEvent(QMoveEvent *event).

[override virtual protected] void QMdiSubWindow::paintEvent(QPaintEvent *paintEvent)

Реализует: QWidget::paintEvent(QPaintEvent *event).

[override virtual protected] void QMdiSubWindow::resizeEvent(QResizeEvent *resizeEvent)

Реализует: QWidget::resizeEvent(QResizeEvent *event).

Предупреждение: При максимизации или восстановлении подокна вызов этой функции может иметь некорректное значение QResizeEvent::oldSize().

void QMdiSubWindow::setOption(QMdiSubWindow::SubWindowOption option, bool on = true)

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

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

void QMdiSubWindow::setSystemMenu(QMenu *systemMenu)

Устанавливает systemMenu как текущее системное меню для этого подокна.

По умолчанию у каждого QMdiSubWindow есть стандартное системное меню.

QActions для системного меню, созданного QMdiSubWindow, будут автоматически обновляться в зависимости от текущего состояния окна; например, действие минимизации будет отключено после минимизации окна.

QActions, добавленные пользователем, не обновляются QMdiSubWindow.

QMdiSubWindow принимает владение над systemMenu; вам не нужно его удалять. Любые существующие меню будут удалены.

См. также systemMenu() и showSystemMenu().

void QMdiSubWindow::setWidget(QWidget *widget)

Устанавливает widget как внутренний виджет этого подокна. Внутренний виджет отображается в центре подокна под строкой заголовка.

QMdiSubWindow временно принимает владение над widget; вам не нужно его удалять. Любой существующий внутренний виджет будет удалён и переродится к главному окну.

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

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

Реализует: QWidget::showEvent(QShowEvent *event).

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

Реализует функцию доступа к свойству: QWidget::sizeHint.

QMenu *QMdiSubWindow::systemMenu() const

Возвращает указатель на текущее системное меню или ноль, если системное меню не установлено. QMdiSubWindow предоставляет системное меню по умолчанию, но вы также можете установить меню с помощью setSystemMenu().

См. также setSystemMenu() и showSystemMenu().

bool QMdiSubWindow::testOption(QMdiSubWindow::SubWindowOption option) const

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

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

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

Реализует: QObject::timerEvent(QTimerEvent *event).

QWidget *QMdiSubWindow::widget() const

Возвращает текущий внутренний виджет.

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