Тип QML ApplicationWindow

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

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

Свойства

• activeFocusControl : Control
• background : Item
• contentData : список<Объект>
• contentItem : Item
• font : шрифт
• footer : Item
• header : Item
• locale : Локаль
• menuBar : Item

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

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

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

ApplicationWindow — это Window, что облегчает добавление панели меню, заголовка и подвала в окно.

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

import QtQuick.Controls 2.12

ApplicationWindow {
    visible: true

    menuBar: MenuBar {
        // ...
    }

    header: ToolBar {
        // ...
    }

    footer: TabBar {
        // ...
    }

    StackView {
        anchors.fill: parent
    }
}

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

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

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

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

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

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

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

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

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

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

background : Item

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

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

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

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

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

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

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

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

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

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

См. также contentItem.

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

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

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

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

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.

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

header : Item

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

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

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

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

locale : Locale

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

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

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

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

[с QtQuick.Controls 2.3 (Qt 5.10)] menuBar : Item

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

ApplicationWindow {
    menuBar: MenuBar {
        // ...
    }
}

Это свойство было добавлено в QtQuick.Controls 2.3 (Qt 5.10).

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

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

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

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

См. также Window::activeFocusItem и Свойства-привязки ApplicationWindow.

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

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

См. также Свойства-привязки ApplicationWindow.

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

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

См. также Свойства-привязки ApplicationWindow.

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

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

См. также Свойства-привязки ApplicationWindow.

[только для чтения, с QtQuick.Controls 2.3 (Qt 5.10)] ApplicationWindow.menuBar : Item

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

Это свойство было добавлено в QtQuick.Controls 2.3 (Qt 5.10).

См. также Свойства-привязки ApplicationWindow.

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

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

См. также Свойства-привязки ApplicationWindow.