Класс 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 для доставки в это окно.

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

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

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

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

[signal] void QWindow::screenChanged(QScreen *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).

См. документацию QWidget::showFullScreen() для платформоспецифических соображений и ограничений.

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

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

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

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

Базовый размер используется для вычисления правильного размера окна, если окно определяет 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() и setFilePath().

bool QWindow::setKeyboardGrabEnabled(bool grab)

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

Если возвращаемое значение равно true, окно получает все события клавиатуры до вызова 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).

Если возвращаемое значение равно true, окно получает все события мыши до вызова 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.

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

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