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

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

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

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

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

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

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

locale : Локаль

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

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

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

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

menuBar : Элемент

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

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

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

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

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.