Тип окна QML

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

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

Свойства

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

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

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

Сигналы

• закрытие(CloseEvent закрыть)

Методы

• alert(int msec)
• закрыть()
• скрыть()
• опустить()
• поднять()
• запрос_активации()
• показать()
• показать_на_весь_экран()
• показать_размер_макс()
• показать_размер_мин()
• показать_нормально()

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

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

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

import QtQuick.Window 2.2

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

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

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

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

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

active : bool

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

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

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

activeFocusItem : Item

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

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

цвет : цвет

Цвет фона для окна.

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

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

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

ориентация_содержимого : Qt::ScreenOrientation

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

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

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

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

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

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

[по умолчанию] данные : list<Object>

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

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

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

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

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

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

флаги : Qt::WindowFlags

Флаги окна.

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

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

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

высота : int

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

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

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

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

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

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

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

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

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

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

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

минимальная_высота : int

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

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

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

minimumWidth : int

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

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

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

modality : Qt::WindowModality

Режим окна.

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

opacity : real

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

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

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

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

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

screen : variant

Экран, с которым ассоциировано окно.

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

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

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

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

title : string

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

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

visibility : QWindow::Visibility

Состояние отображения окна на экране.

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

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

Когда окно не отображается, его состояние visibility — Hidden, и установка visibility в Hidden эквивалентна установке visible в false.

Это свойство было введено в 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"
}

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

Window.activeFocusItem : Item

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

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

Window.contentItem : Item

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

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

Window.height : int

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

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

Window.visibility : QWindow::Visibility

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

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

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

Window.width : int

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

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

Window.window : Window

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

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

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

closing(CloseEvent close)

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

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

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

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

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

alert(int msec)

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

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

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

close()

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

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

hide()

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

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

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

lower()

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

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

raise()

Приподнимает окно в системе окон.

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

requestActivate()

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

Этот метод был введён в 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.