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

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

Элемент содержимого расположен над элементом фона и под элементами 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.

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.

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

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