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

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

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

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

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

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

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

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

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

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

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

См. также contentItem.

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

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

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