Класс QWindow

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

Этот класс был введён в Qt 5.0.

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

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

Свойства

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

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

Публичные слоты

Сигналы

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

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

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

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

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

В приложении обычно используются QWidget или QQuickView для интерфейса пользователя, а не QWindow напрямую. Тем не менее, можно напрямую отображать данные в QWindow с помощью QBackingStore или QOpenGLContext, когда требуется свести к минимуму зависимости или когда необходимо использовать OpenGL напрямую. Примеры «Raster Window» и «OpenGL Window» являются полезными справочными примерами того, как отображать данные в 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

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

Перечисление QWindow::Visibility

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

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

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

QWindow::QWindow(QWindow *parent)

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

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

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

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

QWindow::QWindow(QScreen *targetScreen = nullptr)

Создаёт окно верхнего уровня на экране targetScreen.

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

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

[slot] void QWindow::alert(int msec)

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

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

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

[slot] bool QWindow::close()

Закрывает окно.

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

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

[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() и QWindowsWindowFunctions::setWindowActivationBehavior().

[slot] void QWindow::requestUpdate()

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

Событие доставляется синхронно с обновлением отображения на платформах, где это возможно. В противном случае событие доставляется после задержки в 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().

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

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

[virtual] QWindow::~QWindow()

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

QSize QWindow::baseSize() const

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

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

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 «ретина».

Примечание: Для окон, не поддерживаемых окном платформы, то есть когда 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) отправляется системой окон, когда область окна становится недействительной, например, из-за изменения видимости в системе окон.

Приложение может начать отрисовку в окне с помощью QBackingStore и QOpenGLContext, как только получит exposeEvent(), при условии, что isExposed() равно true.

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

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

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

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

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

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

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

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

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

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, long *result)

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

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

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

QWindow *QWindow::parent(QWindow::AncestorMode mode) const

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

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

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

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

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

QWindow *QWindow::parent() const

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

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

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.

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

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

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

Событие resize вызывается всякий раз, когда окно изменяет размер в системе окон, либо напрямую через систему окон, подтверждающую запрос 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)

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

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

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

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

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

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

void QWindow::setFilePath(const QString &filePath)

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

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

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

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

Если возвращаемое значение 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() его экрана.

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

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() по горизонтали и sizeIncrement() по вертикали, основываясь на 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().

void QWindow::setWindowStates(Qt::WindowStates state)

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

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

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

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

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

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

void QWindow::showEvent(QShowEvent *ev)

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

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

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

QSize QWindow::size() const

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

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

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

QSize QWindow::sizeIncrement() const

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

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

QSurface::SurfaceType QWindow::surfaceType() const

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

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

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

void QWindow::tabletEvent(QTabletEvent *ev)

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

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

void QWindow::touchEvent(QTouchEvent *ev)

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

Qt::WindowType QWindow::type() const

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

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

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

void QWindow::unsetCursor()

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

QVulkanInstance *QWindow::vulkanInstance() const

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

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

void QWindow::wheelEvent(QWheelEvent *ev)

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

WId QWindow::winId() const

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

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

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

Qt::WindowState QWindow::windowState() const

состояние окна относительно занимаемой им области экрана

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

Qt::WindowStates QWindow::windowStates() const

состояние окна относительно занимаемой им области экрана

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

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

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