Класс QWindow

Класс QWindow представляет окно в подлежащей системе окон. Подробнее...

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

Открытые типы

Свойства

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

Реализованные публичные функции

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

Сигналы

Статические публичные члены

Защищённые функции

Реализованные защищённые функции

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

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

Приложение обычно использует QWidget или QQuickView для своего пользовательского интерфейса, а не QWindow напрямую. Тем не менее, можно отображать изображение непосредственно в QWindow с помощью QBackingStore или QOpenGLContext, когда требуется минимальная зависимость или прямой доступ к OpenGL. Примеры Raster Window Example и OpenGL Window Example полезны для иллюстрации отображения в QWindow с помощью любого из подходов.

Управление ресурсами

Окна могут потреблять значительный объём памяти. Обычный показатель — ширина умноженная на высоту умноженная на глубину цвета. Окно также может включать несколько буферов для поддержки двойного и тройного буферирования, а также буферов глубины и маски.

Для освобождения ресурсов памяти окна вызовите функцию destroy().

Ориентация содержимого

QWindow имеет reportContentOrientationChange(), которая позволяет указать расположение содержимого окна относительно экрана. Ориентация содержимого — просто подсказка для системы окон о том, в какой ориентации находится содержимое окна. Это полезно, когда вы хотите сохранить размер окна, но повернуть содержимое вместо этого, особенно при анимации поворота между различными ориентациями. Система окон может использовать это значение для определения расположения системных всплывающих окон или диалоговых окон.

Видимость и экспонирование системой окон

По умолчанию окно невидимо, и вам необходимо вызвать setVisible(true) или show() или аналогичную функцию, чтобы сделать его видимым. Чтобы скрыть окно, вызовите setVisible(false) или hide(). Свойство visible описывает желаемое состояние окна. В зависимости от используемой системы, видимое окно всё равно может не отображаться на экране. Например, оно может быть скрыто другими непрозрачными окнами или перемещено за пределы физической области экрана. В системах окон, которые предоставляют уведомления об экспонировании, свойство isExposed() указывает, должно ли окно считаться непосредственно видимым на экране. Функция exposeEvent() вызывается всякий раз, когда область окна становится недействительной, например, из-за изменения экспонирования в системе окон. В системах окон, которые не предоставляют эту информацию приложению, isExposed() просто вернёт то же значение, что и isVisible().

QWindow::Visibility, запрашиваемая через visibility(), — это удобный API, объединяющий функции visible() и windowStates().

Отображение

Существует два API Qt, которые могут использоваться для отрисовки содержимого в окне: QBackingStore для отрисовки с помощью QPainter и вывода содержимого в окно типа QSurface::RasterSurface, и QOpenGLContext для отрисовки с помощью OpenGL в окно типа QSurface::OpenGLSurface.

Приложение может начать отрисовку, как только isExposed() вернёт true, и может продолжать отрисовку, пока не isExposed() вернёт false. Чтобы узнать, когда isExposed() изменяется, переопределите exposeEvent(). Окно всегда получит событие изменения размера перед первым событием expose.

Начальная геометрия

Если ширина и высота окна не инициализированы, окно получит разумную геометрию по умолчанию от платформенного окна. Если позиция не инициализирована, то платформенное окно позволит системе окон разместить окно. Например, в X11 менеджер окон обычно выполняет некоторое умное позиционирование, чтобы попытаться избежать ситуации, когда новые окна полностью закрывают существующие окна. Однако setGeometry() инициализирует как позицию, так и размер, поэтому, если вам нужна фиксированная размер, но автоматическое позиционирование, следует вызвать resize() или setWidth() и setHeight() вместо этого.

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

перечисление QWindow::AncestorMode

Это перечисление используется для управления тем, считаются ли транзитивные родительские элементы предками или нет.

[since 5.1] перечисление QWindow::Visibility

Это перечисление описывает какую часть экрана занимает или должно занимать окно.

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

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

QWindow::QWindow(QWindow *parent)

Создаёт окно как дочернее окно заданного окна parent.

Окно будет вложено внутрь родительского окна, его координаты относительно родителя.

Экран наследуется от родителя.

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

QWindow::QWindow(QScreen *targetScreen = nullptr)

Создаёт окно как верхнее окно на targetScreen.

Окно не отображается, пока не будет вызвано setVisible(true), show() или аналогичная функция.

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

[slot, since 5.1] void QWindow::alert(int msec)

Приводит к отображению предупреждения на msec миллисекунд. Если msec равно 0 (по умолчанию), то предупреждение отображается неограниченно до тех пор, пока окно снова не станет активным. Эта функция не оказывает влияния на активное окно.

В состоянии предупреждения окно указывает, что требует внимания, например, мигая или подпрыгивая записью в панели задач.

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

[slot] bool QWindow::close()

Закрыть окно.

Закрывает окно, фактически вызывая destroy(), и потенциально завершая приложение. Возвращает true при успехе, false, если есть родительское окно (в этом случае должно быть закрыто верхнее окно).

См. также destroy(), QGuiApplication::quitOnLastWindowClosed() и closeEvent().

[signal] void QWindow::focusObjectChanged(QObject *object)

Этот сигнал испускается, когда конечный получатель событий, связанных с фокусом, изменяется на object.

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

[slot] void QWindow::hide()

Скрыть окно.

Эквивалентно вызову setVisible(false).

См. также show() и setVisible().

[slot] void QWindow::lower()

Опустить окно в системе окон.

Запрос на опускание окна так, чтобы оно отображалось под другими окнами.

[signal] void QWindow::modalityChanged(Qt::WindowModality modality)

Этот сигнал испускается, когда свойство Qwindow::modality меняется на modality.

Примечание: Сигнал уведомления для свойства modality.

[slot] void QWindow::raise()

Поднять окно в системе окон.

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

[slot] void QWindow::requestActivate()

Запрос на активацию окна, т.е. получение фокуса клавиатуры.

См. также isActive() и QGuiApplication::focusWindow().

[slot, since 5.5] void QWindow::requestUpdate()

Планирует событие QEvent::UpdateRequest для доставки в это окно.

Событие доставляется синхронно с синхронизацией отображения (vsync) на платформах, где это возможно. В противном случае событие доставляется с задержкой 5 мс. Дополнительное время предназначено для того, чтобы циклу событий было немного свободного времени для сбора системных событий, и может быть переопределено с помощью переменной окружения QT_QPA_UPDATE_IDLE_TIME.

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

Подклассы QWindow должны переопределять event(), перехватывать событие и вызывать код рендеринга приложения, а затем вызывать реализацию базового класса.

Примечание: Реализация подкласса event() должна вызывать реализацию базового класса, если он абсолютно уверен, что событие не нужно обрабатывать базовому классу. Например, реализация по умолчанию этой функции полагается на события QEvent::Timer. Отфильтрование их, следовательно, нарушит доставку обновлений.

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

[signal] void QWindow::screenChanged(QScreen *screen)

Этот сигнал генерируется, когда экран окна screen изменяется, либо явно задаётся с помощью setScreen(), либо автоматически, когда экран окна удаляется.

[slot] void QWindow::setGeometry(const QRect &rect)

Устанавливает геометрию окна, исключая рамку окна, на rect.

Геометрия относится к virtualGeometry() экрана.

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

[slot] void QWindow::setGeometry(int posx, int posy, int w, int h)

Устанавливает геометрию окна, исключая рамку окна, на прямоугольник, созданный из posx, posy, w и h.

Геометрия относится к virtualGeometry() экрана.

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

[slot] void QWindow::show()

Отображает окно.

Это эквивалентно вызову showFullScreen(), showMaximized() или showNormal(), в зависимости от поведения по умолчанию платформы для типа окна и флагов.

См. также showFullScreen(), showMaximized(), showNormal(), hide(), QStyleHints::showIsFullScreen(), и flags().

[slot] void QWindow::showFullScreen()

Отображает окно во весь экран.

Эквивалентно вызову setWindowStates(Qt::WindowFullScreen) и затем setVisible(true).

См. также setWindowStates() и setVisible().

[slot] void QWindow::showMaximized()

Отображает окно в максимальном размере.

Эквивалентно вызову setWindowStates(Qt::WindowMaximized) и затем setVisible(true).

См. также setWindowStates() и setVisible().

[slot] void QWindow::showMinimized()

Отображает окно в свёрнутом виде.

Эквивалентно вызову setWindowStates(Qt::WindowMinimized) и затем setVisible(true).

См. также setWindowStates() и setVisible().

[slot] void QWindow::showNormal()

Отображает окно в обычном режиме, т.е. ни максимизированным, ни свёрнутым, ни во весь экран.

Эквивалентно вызову setWindowStates(Qt::WindowNoState) и затем setVisible(true).

См. также setWindowStates() и setVisible().

[slot, since 5.15] bool QWindow::startSystemMove()

Запустить операцию перемещения, специфичную для системы.

Вызов этого метода инициирует интерактивную операцию перемещения окна на платформах, поддерживающих её. Точное поведение может варьироваться в зависимости от платформы. Как правило, окно следует за курсором мыши до отпускания кнопки мыши.

На платформах, поддерживающих эту функцию, этот метод перемещения окон предпочтительнее setPosition, потому что он обеспечивает более естественный вид перемещения окон, например, позволяя менеджеру окон прикреплять окно к другим окнам или обеспечивать специальное поведение изменения размера с анимацией при перетаскивании к краю экрана. Более того, на некоторых платформах, таких как Wayland, setPosition не поддерживается, поэтому это единственный способ для приложения влиять на его положение.

Возвращает true, если операция была поддержана системой.

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

[slot, since 5.15] bool QWindow::startSystemResize(Qt::Edges edges)

Запустить операцию изменения размера, специфичную для системы.

Вызов этого метода запускает интерактивную операцию изменения размера окна на платформах, поддерживающих её. Точное поведение может варьироваться в зависимости от платформы. Как правило, окно будет изменять размер так, чтобы его край следовал за курсором мыши.

На платформах, поддерживающих эту функцию, этот метод изменения размера окон предпочтительнее setGeometry, потому что он обеспечивает более естественный вид изменения размера окон, например, позволяя менеджеру окон прикреплять окно к другим окнам или обеспечивать специальное поведение изменения размера с анимацией при перетаскивании к краю экрана.

edges должен представлять собой один край или два смежных края (угол). Другие значения недопустимы.

Возвращает true, если операция была поддержана системой.

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

[signal] void QWindow::windowStateChanged(Qt::WindowState windowState)

Этот сигнал генерируется при изменении состояния окна windowState, либо явно установленного с помощью setWindowStates(), либо автоматически при нажатии пользователем кнопок на панели заголовка или другими способами.

[virtual] QWindow::~QWindow()

Удаляет окно.

QSize QWindow::baseSize() const

Возвращает базовый размер окна.

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

[virtual protected] void QWindow::closeEvent(QCloseEvent *ev)

Переопределите этот метод для обработки событий закрытия (ev).

Функция вызывается, когда окно запрашивает закрытие. Вызовите QEvent::ignore() для события, если вы хотите предотвратить закрытие окна.

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

void QWindow::create()

Выделяет ресурсы платформы, связанные с окном.

В этот момент формат поверхности, установленный с помощью setFormat(), преобразуется в фактическую нативную поверхность. Однако окно остаётся скрытым, пока не будет вызван setVisible().

Обратите внимание, что обычно нет необходимости вызывать эту функцию напрямую, так как она будет неявно вызвана функциями show(), setVisible() и другими функциями, которым требуется доступ к ресурсам платформы.

Вызовите destroy() для освобождения ресурсов платформы, если это необходимо.

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

QCursor QWindow::cursor() const

Форма курсора для этого окна.

См. также setCursor() и unsetCursor().

void QWindow::destroy()

Освобождает нативные ресурсы платформы, связанные с этим окном.

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

qreal QWindow::devicePixelRatio() const

Возвращает отношение между физическими пикселями и пикселями, независимыми от устройства, для окна. Это значение зависит от экрана, на котором находится окно, и может изменяться при перемещении окна.

Общие значения — 1.0 для обычных экранов и 2.0 для экранов Apple «retina».

Примечание: Для окон, не поддерживающих платформенное окно, т.е. когда create() не был вызван, функция вернёт значение отношения пикселей устройства связанного QScreen.

См. также QScreen::devicePixelRatio().

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

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

Переопределите этот метод для обработки любого события (ev), отправленного в окно. Верните true если событие было распознано и обработано.

Помните о вызове версии базового класса, если вы хотите, чтобы события мыши, клавиатуры, изменения размера и т.д. обрабатывались стандартным способом.

[virtual protected] void QWindow::exposeEvent(QExposeEvent *ev)

Событие expose (ev) отправляется системой окон, когда окно переходит из состояния не отображения в состояние отображения.

Отображаемое окно потенциально видно пользователю. Если окно перемещено за пределы экрана, полностью скрыто другим окном, свёрнуто или подобным образом, эта функция может быть вызвана, и значение isExposed() может измениться на false. Вы можете использовать это событие, чтобы ограничить дорогостоящие операции, такие как анимации, только для случаев отображения окна.

Это событие не следует использовать для рисования. Для обработки рисования используйте paintEvent() вместо этого.

Событие изменения размера всегда отправляется перед событием expose при первом отображении окна.

См. также paintEvent() и isExposed().

QString QWindow::filePath() const

Имя файла, представленного этим окном.

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

[virtual protected] void QWindow::focusInEvent(QFocusEvent *ev)

Переопределите этот метод для обработки событий ввода фокуса (ev).

События ввода фокуса отправляются, когда окно получает фокус клавиатуры.

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

[virtual] QObject *QWindow::focusObject() const

Возвращает QObject, который будет конечным получателем событий, связанных с фокусом, таких как события нажатия клавиш.

[virtual protected] void QWindow::focusOutEvent(QFocusEvent *ev)

Переопределите этот метод для обработки событий выхода из фокуса (ev).

События выхода из фокуса отправляются, когда окно теряет фокус клавиатуры.

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

[override virtual] QSurfaceFormat QWindow::format() const

Переопределяет: QSurface::format() const.

Возвращает фактический формат этого окна.

После создания окна эта функция вернёт фактический формат поверхности окна. Он может отличаться от запрошенного формата, если запросённый формат не мог быть выполнен платформой. Также он может быть расширением, например, некоторые размеры буферов могут быть больше, чем запрошенные.

Примечание: В зависимости от платформы некоторые значения в этом формате поверхности могут всё ещё содержать запрошенные значения, то есть значения, переданные в setFormat(). Типичные примеры — версия OpenGL, профиль и опции. Они могут не обновиться во время create(), так как они контекстно-зависимы, и одно окно может использоваться вместе с несколькими контекстами в течение своего жизненного цикла. Для запроса таких значений используйте формат() QOpenGLContext вместо этого.

См. также setFormat(), create(), requestedFormat() и QOpenGLContext::format().

QRect QWindow::frameGeometry() const

Возвращает геометрию окна, включая его рамку.

Геометрия относится к virtualGeometry() экрана.

См. также geometry() и frameMargins().

QMargins QWindow::frameMargins() const

Возвращает отступы рамки окна вокруг окна.

См. также geometry() и frameGeometry().

QPoint QWindow::framePosition() const

Возвращает позицию верхнего левого угла окна, включая его рамку.

Эта функция возвращает то же значение, что и frameGeometry().topLeft().

См. также setFramePosition(), geometry() и frameGeometry().

[static] QWindow *QWindow::fromWinId(WId id)

Создаёт локальное представление окна, созданного другим процессом или с помощью нативных библиотек ниже Qt.

Принимая дескриптор id нативного окна, этот метод создаёт объект QWindow, который может быть использован для представления окна при вызове методов, таких как setParent() и setTransientParent().

Это может использоваться на платформах, которые его поддерживают, для встраивания QWindow внутрь нативного окна или для встраивания нативного окна внутрь QWindow.

Если внешние окна не поддерживаются или встраивание нативного окна не удалось в плагине платформы, эта функция возвращает nullptr.

Примечание: Результирующий QWindow не должен использоваться для манипулирования лежащим в основе нативным окном (кроме смены родительского окна) или для наблюдения за изменениями состояния нативного окна. Любая поддержка таких операций случайная, сильно зависит от платформы и не тестировалась.

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

QRect QWindow::geometry() const

Возвращает геометрию окна, исключая его рамку.

Геометрия относится к virtualGeometry() экрана.

См. также setGeometry(), frameMargins() и frameGeometry().

[virtual protected] void QWindow::hideEvent(QHideEvent *ev)

Переопределите этот метод для обработки событий скрытия (ev).

Функция вызывается, когда окно запросило скрытие в системе окон.

QIcon QWindow::icon() const

Возвращает значок окна в системе окон.

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

bool QWindow::isActive() const

Возвращает true, если окно должно выглядеть активным с точки зрения стиля.

Это относится к окну, имеющему фокус ввода, а также к окнам, которые находятся в той же цепочке родитель/временный родитель, что и окно с фокусом.

Для получения окна, у которого сейчас есть фокус, используйте QGuiApplication::focusWindow().

Примечание: Функция-получатель для свойства active.

bool QWindow::isAncestorOf(const QWindow *child, QWindow::AncestorMode mode = IncludeTransients) const

Возвращает true, если окно является предком данного child. Если mode равен IncludeTransients, то временные родители также считаются предками.

bool QWindow::isExposed() const

Возвращает, отображено ли это окно в системе окон.

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

Событие exposeEvent() отправляется каждый раз, когда это значение изменяется.

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

bool QWindow::isModal() const

Возвращает, является ли окно модальным.

Модальное окно предотвращает получение ввода другими окнами.

См. также QWindow::modality.

bool QWindow::isTopLevel() const

Возвращает, является ли окно верхним уровнем, т.е. у него нет родительского окна.

[virtual protected] void QWindow::keyPressEvent(QKeyEvent *ev)

Переопределите этот метод для обработки событий нажатия клавиш (ev).

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

[virtual protected] void QWindow::keyReleaseEvent(QKeyEvent *ev)

Переопределите этот метод для обработки событий отпускания клавиш (ev).

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

[since 6.0] QPointF QWindow::mapFromGlobal(const QPointF &pos) const

Преобразует глобальные координаты экрана pos в координаты окна.

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

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

QPoint QWindow::mapFromGlobal(const QPoint &pos) const

Это перегруженная функция.

[since 6.0] QPointF QWindow::mapToGlobal(const QPointF &pos) const

Преобразует координаты окна pos в глобальные координаты экрана. Например, mapToGlobal(QPointF(0,0)) даёт глобальные координаты верхнего левого пикселя окна.

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

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

QPoint QWindow::mapToGlobal(const QPoint &pos) const

Это перегруженная функция.

QRegion QWindow::mask() const

Возвращает установленную маску окна.

Маска — подсказка для системы окон, что приложение не хочет получать ввод мыши или касания за пределами указанной области.

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

QSize QWindow::maximumSize() const

Возвращает максимальный размер окна.

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

QSize QWindow::minimumSize() const

Возвращает минимальный размер окна.

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

[virtual protected] void QWindow::mouseDoubleClickEvent(QMouseEvent *ev)

Переопределите этот метод для обработки событий двойного щелчка мышью (ev).

См. также mousePressEvent() и QStyleHints::mouseDoubleClickInterval().

[virtual protected] void QWindow::mouseMoveEvent(QMouseEvent *ev)

Переопределите этот метод для обработки событий перемещения мыши (ev).

[virtual protected] void QWindow::mousePressEvent(QMouseEvent *ev)

Переопределите этот метод для обработки событий нажатия мыши (ev).

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

[virtual protected] void QWindow::mouseReleaseEvent(QMouseEvent *ev)

Переопределите этот метод для обработки событий отпускания мыши (ev).

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

[virtual protected] void QWindow::moveEvent(QMoveEvent *ev)

Переопределите этот метод для обработки событий перемещения окна (ev).

[virtual protected] bool QWindow::nativeEvent(const QByteArray &eventType, void *message, qintptr *result)

Переопределите этот метод для обработки событий, зависящих от платформы. Будут переданы eventType, message и result.

Это может сделать ваше приложение непереносимым.

Должен возвращать true только в случае обработки события.

[virtual protected, since 6.0] void QWindow::paintEvent(QPaintEvent *ev)

Событие отрисовки (ev) отправляется системой окон, когда требуется перерисовка области окна, например, при первоначальном отображении окна или при раскрытии части окна из-за перемещения другого окна.

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

Данная функция была добавлена в Qt 6.0.

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

[since 5.9] QWindow *QWindow::parent(QWindow::AncestorMode mode = ExcludeTransients) const

Возвращает родительское окно, если оно есть.

Если mode равен IncludeTransients, то возвращается временный родитель, если родителя нет.

Окно без родителя называется окном верхнего уровня.

Данная функция была добавлена в Qt 5.9.

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

QPoint QWindow::position() const

Возвращает положение окна на рабочем столе, исключая рамку окна.

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

QSurfaceFormat QWindow::requestedFormat() const

Возвращает запрошенный формат поверхности этого окна.

Если запрошенный формат не поддерживается реализацией платформы, requestedFormat будет отличаться от фактического формата окна.

Это значение, установленное с помощью setFormat().

См. также setFormat() и format().

void QWindow::resize(const QSize &newSize)

Устанавливает размер окна, исключая рамку, на newSize.

См. также size() и geometry().

void QWindow::resize(int w, int h)

Устанавливает размер окна, исключая рамку, на QSize, построенный из ширины w и высоты h.

Для интерактивного изменения размера окон, см. startSystemResize().

См. также size() и geometry().

[virtual protected] void QWindow::resizeEvent(QResizeEvent *ev)

Переопределите этот метод для обработки событий изменения размера (ev).

Событие изменения размера вызывается всякий раз, когда окно изменяет размер в системе окон, либо непосредственно через систему окон, подтверждающую запрос setGeometry() или resize(), либо косвенно, когда пользователь вручную изменяет размер окна.

QScreen *QWindow::screen() const

Возвращает экран, на котором отображается окно, или null, если такового нет.

Для дочерних окон возвращается экран соответствующего окна верхнего уровня.

См. также setScreen() и QScreen::virtualSiblings().

void QWindow::setBaseSize(const QSize &size)

Устанавливает базовый размер size окна.

Базовый размер используется для вычисления правильного размера окна, если окно определяет sizeIncrement().

См. также setMinimumSize(), setMaximumSize(), setSizeIncrement(), и baseSize().

void QWindow::setCursor(const QCursor &cursor)

Устанавливает форму курсора для данного окна.

Курсор мыши примет эту форму, когда он находится над этим окном, если не установлен переопределяющий курсор. Список предопределенных объектов курсора см. в списке.

Если курсор не установлен или после вызова unsetCursor(), используется курсор родительского окна.

По умолчанию форма курсора — Qt::ArrowCursor.

Некоторые реализации оконных систем будут сбрасывать курсор, если он покидает окно, даже если мышь захвачена. Если вы хотите установить курсор для всех окон, даже когда он находится за пределами окна, используйте QGuiApplication::setOverrideCursor().

См. также cursor() и QGuiApplication::setOverrideCursor().

void QWindow::setFilePath(const QString &filePath)

Устанавливает имя файла, который представляет это окно.

Система окон может использовать filePath для отображения пути к документу, который представляет это окно, в строке заголовка.

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

[since 5.9] void QWindow::setFlag(Qt::WindowType flag, bool on = true)

Устанавливает флаг окна flag в этом окне, если on равно true; в противном случае сбрасывает флаг.

Данная функция была добавлена в Qt 5.9.

См. также setFlags(), flags(), и type().

void QWindow::setFormat(const QSurfaceFormat &format)

Устанавливает формат поверхности окна format.

Формат определяет такие свойства, как глубина цвета, альфа, размер буферов глубины и трафарета и т. д. Например, чтобы сделать фон окна прозрачным (при условии, что система окон поддерживает композицию и что другое содержимое окна не делает его непрозрачным):

QSurfaceFormat format;
format.setAlphaBufferSize(8);
window.setFormat(format);

Формат поверхности будет разрешен в функции create(). Вызов этой функции после вызова create() не повторно разрешит формат поверхности для нативной поверхности.

Если формат не установлен явно, будет использован формат, возвращаемый QSurfaceFormat::defaultFormat(). Это означает, что при наличии нескольких окон, отдельные вызовы этой функции могут быть заменены одним вызовом QSurfaceFormat::setDefaultFormat() перед созданием первого окна.

См. также format(), create(), destroy(), и QSurfaceFormat::setDefaultFormat().

void QWindow::setFramePosition(const QPoint &point)

Устанавливает верхнее левое положение окна (point), включая его рамку.

Положение относится к virtualGeometry() экрана.

См. также framePosition(), setGeometry(), и frameGeometry().

void QWindow::setIcon(const QIcon &icon)

Устанавливает значок окна icon в системе окон.

Значок окна может использоваться системой окон, например, для оформления окна и/или в переключателе задач.

Примечание: На macOS значок в строке заголовка окна предназначен для окон, представляющих документы, и отображается только в том случае, если также установлен путь к файлу.

См. также icon() и setFilePath().

bool QWindow::setKeyboardGrabEnabled(bool grab)

Устанавливает, должен ли быть включен захват клавиатуры (grab).

Если возвращаемое значение истинно, окно получает все события клавиатуры до тех пор, пока не будет вызван setKeyboardGrabEnabled(false); другие окна не получают никаких событий клавиатуры вообще. События мыши не затрагиваются. Используйте setMouseGrabEnabled(), если хотите захватить их.

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

void QWindow::setMask(const QRegion &region)

Устанавливает маску окна.

Маска — это подсказка для системы окон, что приложение не хочет получать события мыши или касания вне заданной области region.

Менеджер окон может или не может отображать области окна, не включенные в маску, поэтому приложение несет ответственность за установку прозрачности для областей, которые не являются частью маски.

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

void QWindow::setMaximumSize(const QSize &size)

Устанавливает максимальный размер окна.

Это подсказка для менеджера окон, чтобы предотвратить изменение размера, превышающего указанный size.

См. также setMinimumSize() и maximumSize().

void QWindow::setMinimumSize(const QSize &size)

Устанавливает минимальный размер окна.

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

См. также setMaximumSize() и minimumSize().

bool QWindow::setMouseGrabEnabled(bool grab)

Устанавливает, должен ли быть включен захват мыши (grab).

Если возвращаемое значение истинно, окно получает все события мыши до тех пор, пока не будет вызван setMouseGrabEnabled(false); другие окна не получают никаких событий мыши вообще. События клавиатуры не затрагиваются. Используйте setKeyboardGrabEnabled(), если хотите захватить их.

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

void QWindow::setParent(QWindow *parent)

Устанавливает родительское окно parent. Это приведет к тому, что система окон будет управлять обрезкой окна, поэтому оно будет обрезано до родительского окна parent.

Установка parent в nullptr сделает окно верхним уровнем.

Если parent — это окно, созданное с помощью fromWinId(), то текущее окно будет вложено в parent, если платформа это поддерживает.

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

void QWindow::setPosition(const QPoint &pt)

Устанавливает положение окна на рабочем столе в pt

Положение относительно virtualGeometry() экрана.

Для интерактивного перемещения окон см. startSystemMove(). Для интерактивного изменения размера окон см. startSystemResize().

См. также position() и startSystemMove().

void QWindow::setPosition(int posx, int posy)

Устанавливает положение окна на рабочем столе в posx, posy

Положение относительно virtualGeometry() экрана.

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

void QWindow::setScreen(QScreen *newScreen)

Устанавливает экран, на котором должно быть показано окно.

Если окно было создано, оно будет пересоздано на экране newScreen.

Примечание: Если экран является частью виртуального рабочего стола с несколькими экранами, окно не переместится автоматически на newScreen. Чтобы разместить окно относительно экрана, используйте свойство topLeft() экрана.

Эта функция работает только для окон верхнего уровня.

См. также screen() и QScreen::virtualSiblings().

void QWindow::setSizeIncrement(const QSize &size)

Устанавливает приращение размера (size) окна.

При изменении размера окна размер будет изменяться шагами sizeIncrement().width() пикселей по горизонтали и sizeIncrement().height() пикселей по вертикали, основой для которых служит baseSize().

По умолчанию это свойство содержит размер с нулевой шириной и высотой.

Система окон может не поддерживать приращения размера.

См. также sizeIncrement(), setBaseSize(), setMinimumSize() и setMaximumSize().

void QWindow::setSurfaceType(QSurface::SurfaceType surfaceType)

Устанавливает тип поверхности surfaceType окна.

Определяет, предназначено ли окно для растровой отрисовки с помощью QBackingStore или для отрисовки с помощью OpenGL с помощью QOpenGLContext.

Свойство surfaceType будет использоваться при создании нативного интерфейса в функции create(). Вызов этой функции после создания нативного интерфейса требует вызова destroy() и create() для освобождения старого нативного интерфейса и создания нового.

См. также surfaceType(), QBackingStore, QOpenGLContext, create() и destroy().

void QWindow::setVulkanInstance(QVulkanInstance *instance)

Связывает это окно со указанным экземпляром Vulkan instance.

instance должен оставаться валидным, пока существует экземпляр QWindow.

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

void QWindow::setWindowState(Qt::WindowState state)

Устанавливает состояние окна в системе окон

Состояние окна state определяет, отображается ли окно в системе окон как максимализированное, минимизированное, полноэкранное или нормальное.

Значение перечисления Qt::WindowActive не является допустимым параметром.

См. также windowState(), showNormal(), showFullScreen(), showMinimized(), showMaximized() и setWindowStates().

[since 5.10] void QWindow::setWindowStates(Qt::WindowStates state)

Устанавливает состояние окна в системе окон

Состояние окна state определяет, отображается ли окно в системе окон как максимализированное, минимизированное и/или полноэкранное.

Окно может находиться в комбинации нескольких состояний. Например, если окно минимизировано и максимизировано одновременно, оно будет отображаться минимизированным, но щелчок по записи в панели задач восстановит его в максимализированном состоянии.

Значение перечисления Qt::WindowActive не должно устанавливаться.

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

См. также windowStates(), showNormal(), showFullScreen(), showMinimized() и showMaximized().

[virtual protected] void QWindow::showEvent(QShowEvent *ev)

Переопределите этот метод для обработки событий отображения (ev).

Функция вызывается, когда окно запросило видимость.

Если окно успешно отображено системой окон, за этим последует событие изменения размера и события вывода.

[override virtual] QSize QWindow::size() const

Реализует: QSurface::size() const.

Возвращает размер окна, исключая рамку окна.

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

QSize QWindow::sizeIncrement() const

Возвращает приращение размера окна.

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

[override virtual] QSurface::SurfaceType QWindow::surfaceType() const

Реализует: QSurface::surfaceType() const.

Возвращает тип поверхности окна.

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

[virtual protected] void QWindow::tabletEvent(QTabletEvent *ev)

Переопределите этот метод для обработки событий касания планшетом (ev).

События входа и выхода в зону действия не отправляются окнам, они передаются экземпляру приложения.

[virtual protected] void QWindow::touchEvent(QTouchEvent *ev)

Переопределите этот метод для обработки событий касания (ev).

Qt::WindowType QWindow::type() const

Возвращает тип окна.

Это возвращает часть флагов окна, которая указывает, является ли окно диалоговым окном, всплывающей подсказкой, всплывающим окном, обычным окном и т. д.

См. также flags() и setFlags().

void QWindow::unsetCursor()

Восстанавливает стандартный курсор стрелки для этого окна.

QVulkanInstance *QWindow::vulkanInstance() const

Возвращает связанную инстанцию Vulkan, если она была установлена, в противном случае nullptr.

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

[virtual protected] void QWindow::wheelEvent(QWheelEvent *ev)

Переопределите этот метод для обработки событий прокрутки мыши или других событий прокрутки (ev).

WId QWindow::winId() const

Возвращает идентификатор платформы окна.

Для платформ, где этот идентификатор может быть полезен, возвращаемое значение будет уникально представлять окно внутри соответствующего экрана.

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

Qt::WindowState QWindow::windowState() const

Состояние окна в отношении занимаемого им места на экране.

См. также setWindowState() и windowStates().

[since 5.10] Qt::WindowStates QWindow::windowStates() const

Состояние окна в отношении занимаемого им места на экране.

Окно может находиться в комбинации нескольких состояний. Например, если окно минимизировано и максимизировано одновременно, оно будет выглядеть минимизированным, но щелчок по записи в области задач восстановит его в максимизированном состоянии.

Этот метод был добавлен в Qt 5.10.

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