Тип QML ApplicationWindow

Стиль верхнего уровня окна с поддержкой заголовка и подвала. Подробнее...

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

Свойства

• activeFocusControl : Control
• background : Item
• contentData : список<Объект>
• contentItem : Item
• font : шрифт
• footer : Item
• header : Item
• locale : Локаль
• overlay
  • overlay : Item
  • overlay.modal : Компонент
  • overlay.modeless : Компонент

Прикрепленные свойства

• activeFocusControl : Control
• contentItem : Item
• footer : Item
• header : Item
• overlay : Item
• window : ApplicationWindow

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

ApplicationWindow — это Window, которое упрощает добавление элемента header и footer в окно.

Вы можете объявить ApplicationWindow как корневой элемент вашего приложения и запустить его с помощью QQmlApplicationEngine. Таким образом, вы можете управлять свойствами, внешним видом и макетом окна из QML.

import QtQuick.Controls 2.1

ApplicationWindow {
    visible: true

    header: ToolBar {
        // ...
    }

    footer: TabBar {
        // ...
    }

    StackView {
        anchors.fill: parent
    }
}

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

Примечание: По умолчанию ApplicationWindow не отображается.

Прикрепленные свойства ApplicationWindow

Из-за того, как работает Область действия и разрешение имён в QML, можно ссылаться на id корневого элемента приложения в любом месте его дочерних QML-объектов. Хотя этот подход подходит для многих приложений и случаев использования, для общего QML-компонента он может быть неприемлемым, так как создаёт зависимость от окружающей среды.

ApplicationWindow предоставляет набор прикреплённых свойств, которые могут использоваться для доступа к окну и его составным частям из мест, где прямой доступ к окну недоступен, не создавая при этом зависимости от конкретного окна id. QML-компонент, использующий прикреплённые свойства ApplicationWindow, работает в любом окне независимо от его id. В следующем примере используется прикреплённое overlay свойство для размещения всплывающего окна по центру окна, несмотря на положение кнопки, открывающей всплывающее окно.

Button {
    onClicked: popup.open()

    Popup {
        id: popup

        parent: ApplicationWindow.overlay

        x: (parent.width - width) / 2
        y: (parent.height - height) / 2
        width: 100
        height: 100
    }
}

См. также Настройка ApplicationWindow, Page и Контейнерные элементы управления.

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

[только для чтения] activeFocusControl : Control

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

Разница между Window::activeFocusItem и ApplicationWindow::activeFocusControl заключается в том, что первый может указывать на составную часть элемента управления, а второй — на само содержащее элемент управления. Например, когда у SpinBox есть фокус, activeFocusItem указывает на редактор, а activeFocusControl — на сам SpinBox.

См. также Window::activeFocusItem.

background : Item

Это свойство содержит элемент фона.

Элемент фона расположен под элементом содержимого, но над цветом фона окна.

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

Примечание: Если у элемента фона нет явно указанного размера, он автоматически принимает размер элемента управления. В большинстве случаев нет необходимости указывать ширину или высоту для элемента фона.

См. также Настройка ApplicationWindow, contentItem, header, footer и overlay.

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

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

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

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

Обычно нет необходимости ссылаться на свойство contentData, так как оно является свойством по умолчанию для ApplicationWindow, и поэтому все дочерние элементы автоматически присваиваются этому свойству.

См. также contentItem.

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

Это свойство содержит элемент содержимого окна.

Элемент содержимого расположен поверх элементом background и под элементами header, footer и overlay.

См. также background, header, footer и overlay.

font : font

Это свойство содержит текущий шрифт, установленный для окна.

Шрифт по умолчанию зависит от системной среды. QGuiApplication поддерживает системный/тематический шрифт, который используется в качестве значения по умолчанию для всех окон приложения. Вы также можете установить шрифт по умолчанию для окон, передав пользовательский шрифт в QGuiApplication::setFont() до загрузки любого QML. Наконец, шрифт сравнивается с базой данных шрифтов Qt, чтобы найти наилучшее соответствие.

ApplicationWindow распространяет явные свойства шрифта на дочерние элементы управления. Если вы измените определённое свойство шрифта окна, это свойство распространяется на все дочерние элементы управления в окне, заменяя любые системные значения по умолчанию для этого свойства.

См. также Control::font.

footer : Item

Это свойство содержит элемент нижней части окна. Элемент нижней части окна расположен внизу и имеет ширину окна. Значение по умолчанию — null.

ApplicationWindow {
    footer: ToolBar {
        // ...
    }
}

Примечание: Присваивание ToolBar, TabBar или DialogButtonBox в качестве нижней части окна автоматически устанавливает соответствующее свойство ToolBar::position, TabBar::position или DialogButtonBox::position в значение Footer.

См. также header и Page::footer.

header : Item

Это свойство содержит элемент заголовка окна. Элемент заголовка расположен вверху и имеет ширину окна. Значение по умолчанию — null.

ApplicationWindow {
    header: TabBar {
        // ...
    }
}

Примечание: Присваивание ToolBar, TabBar или DialogButtonBox в качестве заголовка окна автоматически устанавливает соответствующее свойство ToolBar::position, TabBar::position или DialogButtonBox::position в значение Header.

См. также footer и Page::header.

locale : Locale

Это свойство содержит локаль окна.

Локаль по умолчанию зависит от системной среды. Вы можете установить локаль по умолчанию, вызвав QLocale::setDefault(), перед загрузкой любого QML.

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

См. также Control::locale и LayoutMirroring.

overlay : Item

Это свойство содержит элемент наложения окна. Поп-апы автоматически переназначаются элементу наложения.

См. также Popup::modal и Popup::dim.

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

[только для чтения] ApplicationWindow.activeFocusControl : Control

Это присоединённое свойство содержит элемент управления, который в настоящее время имеет активный фокус, или null, если нет элемента управления с активным фокусом. Свойство может быть присоединённым к любому элементу. Значение — null, если элемент не находится в ApplicationWindow, или окно не имеет активного фокуса.

См. также Window::activeFocusItem и Присоединённые свойства ApplicationWindow.

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

Это присоединённое свойство содержит элемент содержимого окна. Свойство может быть присоединённым к любому элементу. Значение — null, если элемент не находится в ApplicationWindow.

См. также Присоединённые свойства ApplicationWindow.

[только для чтения] ApplicationWindow.footer : Item

Это присоединённое свойство содержит элемент нижней части окна. Свойство может быть присоединённым к любому элементу. Значение — null, если элемент не находится в ApplicationWindow, или в окне нет элемента нижней части.

См. также Присоединённые свойства ApplicationWindow.

[только для чтения] ApplicationWindow.header : Item

Это присоединённое свойство содержит элемент заголовка окна. Свойство может быть присоединённым к любому элементу. Значение — null, если элемент не находится в ApplicationWindow, или в окне нет элемента заголовка.

См. также Присоединённые свойства ApplicationWindow.

[только для чтения] ApplicationWindow.overlay : Item

Это присоединённое свойство содержит элемент наложения окна. Свойство может быть присоединённым к любому элементу. Значение — null, если элемент не находится в ApplicationWindow.

См. также Присоединённые свойства ApplicationWindow.

[только для чтения] ApplicationWindow.window : ApplicationWindow

Это присоединённое свойство содержит окно приложения. Свойство может быть присоединённым к любому элементу. Значение — null, если элемент не находится в ApplicationWindow.

См. также Присоединённые свойства ApplicationWindow.