Тип QML ApplicationWindow

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

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

Свойства

• activeFocusControl : Control
• background : Item
• contentData : список<Объект>
• contentItem : Item
• font : шрифт
• footer : Item
• header : Item
• locale : 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

Из-за того, как работает разрешение области видимости и именования в 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

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

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

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

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

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

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

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

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

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

См. также contentItem.

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

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

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

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

font : шрифт

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

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

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

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

footer : Item

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

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

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

header : Item

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

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

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

locale : Locale

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

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

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

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

[с 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.