Тип 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.3

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

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

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

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

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

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

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

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

Свойство data позволяет свободно смешивать визуальные дочерние элементы, ресурсы и другие окна в 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 {
        // ...
    }
}

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

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

header : Элемент

Это свойство содержит элемент заголовка окна. Элемент заголовка расположен в верхней части окна, ниже панели меню, и имеет ширину всего окна. Значение по умолчанию — 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 : Элемент

Это свойство содержит панель меню окна. Панель меню расположена в верхней части окна, над заголовком, и имеет ширину всего окна. Значение по умолчанию — 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.

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

[только для чтения] ApplicationWindow.activeFocusControl : Элемент управления

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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