Тип QML ApplicationWindow

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

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

Свойства

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

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

• 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 2.

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

[только для чтения] 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

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

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

См. также 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.

menuBar : Item

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

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

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

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

palette : palette

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

Палитра по умолчанию зависит от системной среды. QGuiApplication поддерживает системную/темовую палитру, которая служит значением по умолчанию для всех окон приложения. Вы также можете установить палитру по умолчанию для окон, передав пользовательскую палитру в QGuiApplication::setPalette() до загрузки любого QML.

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

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

См. также Control::palette, Popup::palette и палитры QML Basic Type.

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

[только для чтения] 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.

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

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

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

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

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

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

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