Тип QML окна

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

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

Свойства

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

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

• active : 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.

цвет : цвет

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

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

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

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

contentOrientation : Qt::ScreenOrientation

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

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

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

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

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

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

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

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

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

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

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

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

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

флаги : 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.

минимальная высота : 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.

title : string

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

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

visibility : QWindow::Visibility

Состояние оккупации экрана окном.

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

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

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

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

См. также visible.

visible : bool

Определяет, видно ли окно на экране.

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

См. также visibility.

width : int

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

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

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

x : int

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

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

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

y : int

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

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

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.

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

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.