Тип 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
• окно : Window

Сигналы

• 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

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

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

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

activeFocusItem : Item

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

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

цвет : цвет

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

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

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

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

contentOrientation : Qt::ScreenOrientation

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

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

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

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

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

См. также Screen.

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

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

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

Если вы назначите 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

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

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

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