Тип окна QML

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

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

Свойства

• active : bool
• activeFocusItem : Item
• цвет : цвет
• contentItem : Item
• contentOrientation : Qt::ScreenOrientation
• данные : список<Объект>
• флаги : Qt::WindowFlags
• высота : int
• максимальнаяВысота : int
• максимальнаяШирина : int
• минимальнаяВысота : int
• минимальнаяШирина : int
• модальность : Qt::WindowModality
• прозрачность : real
• экран : значение
• заголовок : строка
• видимость : QWindow::Visibility
• видимый : bool
• ширина : int
• x : int
• y : int

Присоединённые свойства

• активный : bool
• activeFocusItem : Item
• contentItem : Item
• высота : int
• видимость : QWindow::Visibility
• ширина : int
• окно : Окно

Сигналы

• void closing(CloseEvent close)

Методы

• alert(int msec)
• закрыть()
• скрыть()
• опустить()
• поднять()
• requestActivate()
• показать()
• показатьНаВесьЭкран()
• показатьМаксимизированным()
• показатьМинимизированным()
• показатьНормальным()

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

Объект Window создаёт новое окно верхнего уровня для сцены Qt Quick. Он автоматически настраивает окно для использования с QtQuick 2.x графическими типами.

Для использования этого типа, вам необходимо импортировать модуль следующей строкой:

import QtQuick.Window 2.2

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

Окно может быть объявлено внутри Item или внутри другого окна; в этом случае внутреннее окно автоматически станет «временным для» внешнего окна: большинство платформ будут отображать его по центру внешнего окна по умолчанию, и могут быть другие платформенно-зависимые поведения, также зависящие от флагов. Если вложенное окно предназначено для диалогового окна в вашем приложении, вы также должны установить флаги в Qt.Dialog, потому что некоторые менеджеры окон не обеспечат центрирование без этого флага. Вы также можете объявить несколько окон внутри верхнего уровня QtObject, в этом случае окна не будут иметь временных отношений.

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

Когда пользователь пытается закрыть окно, будет выпущен сигнал closing. Вы можете принудительно оставить окно открытым (например, чтобы запросить у пользователя сохранение изменений) написав обработчик onClosing и установив close.accepted = false.

Документация свойств

active : bool

Статус активности окна.

Это свойство QML было добавлено в Qt 5.1.

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

activeFocusItem : Item

Элемент, который в настоящее время имеет активный фокус, или null если нет элемента с активным фокусом.

Это свойство QML было добавлено в Qt 5.1.

цвет : цвет

Цвет фона окна.

Установка этого свойства более эффективна, чем использование отдельного Rectangle.

[только для чтения] contentItem : Item

Невидимый корневой элемент сцены.

contentOrientation : Qt::ScreenOrientation

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

Рекомендуемая ориентация — Screen.orientation, но приложение не обязано поддерживать все возможные ориентации и может выбрать игнорирование текущей ориентации экрана.

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

Значение по умолчанию — Qt::PrimaryOrientation.

Это свойство QML было добавлено в Qt 5.1.

См. также Экран.

[по умолчанию] данные : список<Объект>

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

Если вы присваиваете другое окно списку данных, вложенное окно станет «временным для» внешнего окна.

Если вы присваиваете Item списку данных, он становится дочерним элементом contentItem окна, таким образом, что он появляется внутри окна. Родительским элементом элемента будет contentItem окна, который является корнем дерева владения Item внутри данного окна.

Если вы присваиваете любой другой тип объекта, он добавляется как ресурс.

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

См. также QWindow::transientParent().

флаги : Qt::WindowFlags

Флаги окна.

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

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

См. также Qt::WindowFlags.

высота : int

Определяет позицию и размер окна.

Позиция (x, y) относительна к Screen, если он один, или к виртуальному рабочему столу (расположению нескольких экранов).

Window { x: 100; y: 100; width: 100; height: 100 }

максимальнаяВысота : int

Определяет максимальный размер окна.

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

Это свойство QML было добавлено в Qt 5.1.

максимальнаяШирина : int

Определяет максимальный размер окна.

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

Это свойство QML было добавлено в Qt 5.1.

minimumHeight : int

Определяет минимальный размер окна.

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

Это свойство QML было введено в Qt 5.1.

minimumWidth : int

Определяет минимальный размер окна.

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

Это свойство QML было введено в Qt 5.1.

modality : Qt::WindowModality

Режим окна.

Модальное окно предотвращает получение других окон событий ввода. Возможные значения: Qt.NonModal (по умолчанию), Qt.WindowModal и Qt.ApplicationModal.

opacity : real

Непрозрачность окна.

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

Значение 1.0 или выше обрабатывается как полностью непрозрачное, а значение 0.0 или ниже — как полностью прозрачное. Промежуточные значения представляют различные уровни полупрозрачности между двумя крайностями.

Значение по умолчанию — 1.0.

Это свойство QML было введено в Qt 5.1.

screen : variant

Экран, с которым связано окно.

Если указано до отображения окна, оно будет отображено на этом экране, если не задано явное положение окна. Значение должно быть элементом из массива Qt.application.screens.

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

Это свойство QML было введено в Qt 5.9.

См. также QWindow::setScreen(), QWindow::screen(), QScreen и Qt.application.

title : string

Заголовок окна в системе окон.

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

visibility : QWindow::Visibility

Состояние заполнения экрана окном.

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

Установление видимости в AutomaticVisibility означает задание состояния видимости по умолчанию для окна, которое может быть FullScreen или Windowed в зависимости от платформы. Однако при чтении свойства видимости вы всегда получите фактическое состояние, а не AutomaticVisibility.

Когда окно не видимо, его видимость — Hidden, и установка видимости в Hidden эквивалентна установке visible в false.

Это свойство QML было введено в Qt 5.1.

См. также visible.

visible : bool

Является ли окно видимым на экране.

Указание visible в false эквивалентно установке visibility в Hidden.

См. также visibility.

width : int

Определяет положение и размер окна.

Положение (x, y) относительно экрана, если он один, или виртуального рабочего стола (расположение нескольких экранов).

Window { x: 100; y: 100; width: 100; height: 100 }

x : int

Определяет положение и размер окна.

Положение (x, y) относительно экрана, если он один, или виртуального рабочего стола (расположение нескольких экранов).

Window { x: 100; y: 100; width: 100; height: 100 }

y : int

Определяет положение и размер окна.

Положение (x, y) относительно экрана, если он один, или виртуального рабочего стола (расположение нескольких экранов).

Window { x: 100; y: 100; width: 100; height: 100 }

Документация присоединённых свойств

Window.active : bool

Это присоединённое свойство указывает, является ли окно активным. Присоединённое свойство Window может быть присоединённо к любому элементу Item.

Вот пример, который изменяет метку, чтобы показать активное состояние окна, в котором она отображается:

import QtQuick 2.4
import QtQuick.Window 2.2

Text {
    text: Window.active ? "active" : "inactive"
}

Это свойство QML было введено в Qt 5.4.

Window.activeFocusItem : Item

Это присоединённое свойство содержит элемент, который в настоящее время имеет активный фокус, или null если нет элемента с активным фокусом. Присоединённое свойство Window может быть присоединённо к любому элементу Item.

Это свойство QML было введено в Qt 5.4.

Window.contentItem : Item

Это присоединённое свойство содержит корневой невидимый элемент сцены или null если элемент не находится в окне. Присоединённое свойство Window может быть присоединённо к любому элементу Item.

Это свойство QML было введено в Qt 5.4.

Window.height : int

Эти присоединённые свойства содержат размер окна элемента. Присоединённое свойство Window может быть присоединённо к любому элементу Item.

Это свойство QML было введено в Qt 5.5.

Window.visibility : QWindow::Visibility

Это присоединённое свойство содержит значение, показывающее, отображается ли окно в настоящее время в системе окон как обычное, свёрнутое, максимальное, полноэкранное или скрытое. Присоединённое свойство Window может быть присоединённо к любому элементу Item. Если элемент не отображается ни в одном окне, значение будет Hidden.

Это свойство QML было введено в Qt 5.4.

См. также visible и visibility.

Window.width : int

Эти присоединённые свойства содержат размер окна элемента. Присоединённое свойство Window может быть присоединённо к любому элементу Item.

Это свойство QML было введено в Qt 5.5.

Window.window : Window

Это присоединённое свойство содержит окно элемента. Присоединённое свойство Window может быть присоединённо к любому элементу Item.

Это свойство QML было введено в Qt 5.7.

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

void closing(CloseEvent close)

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

Этот сигнал включает параметр close. Свойство close.accepted по умолчанию равно true, так что окно разрешено закрыть; но вы можете реализовать обработчик onClosing, и установить close.accepted = false, если вам нужно сделать что-то ещё, прежде чем окно можно закрыть.

Соответствующий обработчик — onClosing.

Этот сигнал QML был введён в Qt 5.1.

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

alert(int msec)

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

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

Этот метод QML был введён в Qt 5.1.

close()

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

При вызове этого метода или при попытке пользователя закрыть окно кнопкой заголовка будет генерироваться сигнал closing. Если обработчика нет или он не отменяет разрешение на закрытие, окно будет впоследствии закрыто. Если свойство QGuiApplication::quitOnLastWindowClosed равно true, и нет других открытых окон, приложение завершится.

hide()

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

Эквивалентно установке visible в false или visibility в Hidden.

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

lower()

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

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

raise()

Возвышает окно в системе окон.

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

requestActivate()

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

Этот метод QML был введён в Qt 5.1.

show()

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

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

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

showFullScreen()

Отображает окно в полноэкранном режиме.

Эквивалентно установке visibility в FullScreen.

showMaximized()

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

Эквивалентно установке visibility в Maximized.

showMinimized()

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

Эквивалентно установке visibility в Minimized.

showNormal()

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

Эквивалентно установке visibility в Windowed.