应用 QML 类型

提供对多个 QML 组件共享的全球应用程序状态属性的访问。更多...

导入语句	import QtQuick

属性

arguments : QStringList
displayName : QString
domain : QString
font : QFont
layoutDirection : Qt::LayoutDirection
name : QString
organization : QString
screens : QQmlListProperty<QQuickScreenInfo>
state : Qt::ApplicationState
styleHints : StyleHints
supportsMultipleWindows : bool
version : QString

信号

aboutToQuit()

详细描述

Application 单例公开了 QApplication 属性的子集以供 QML 应用访问。

它还提供了一个 aboutToQuit() 信号，与 QCoreApplication::aboutToQuit() 相同。

import QtQuick

Window {
    id: root
    visible: true
    width: 800
    height: 680

    title: `${Application.name} (${Application.version})`

    Connections {
        target: Application
        function onAboutToQuit() {
            console.log("Bye!")
        }
    }
}

另请参阅 SystemPalette.

属性文档

arguments : QStringList

这是一个包含启动可执行文件时使用的参数的字符串列表。

displayName : QString

此属性代表在 QGuiApplication 实例上设置的应用程序显示名称。此属性可以被写入以设置应用程序显示名称。

Binding {
    target: Application
    property: "displayName"
    value: "My Awesome Application"
}

domain : QString

这是在 QCoreApplication 实例上设置的组织域。此属性可以被写入以设置组织域。

font : QFont [只读]

返回由 QGuiApplication::font() 返回的默认应用程序字体。

layoutDirection : Qt::LayoutDirection [只读]

这个只读属性可用于查询应用程序的默认布局方向。在系统启动时，默认布局方向取决于应用程序的语言。在文本和图形元素从右到左读取的区域，该属性值为Qt.RightToLeft，而在从左到右读取的区域则值为Qt.LeftToRight。您可以绑定到此属性，以自定义应用程序布局以支持两种布局方向。

RowLayout {
    layoutDirection: Application.layoutDirection
}

name : QString

这是在QCoreApplication实例上设置的程序名称。可以通过写入此属性来设置程序名称。

organization : QString

这是在QCoreApplication实例上设置的机构名称。可以通过写入此属性来设置机构名称。

screens : QQmlListProperty<QQuickScreenInfo> [只读]

包含所有连接屏幕描述的数组。数组元素是具有与Screen附加对象相同属性的对象。实际上，该数组对应于由QGuiApplication::screens()返回的屏幕列表。除了检查名称、宽度、高度等属性外，数组元素还可以分配给窗口项的屏幕属性，从而作为C++侧的QWindow::setScreen()的替代方案。

另请参阅Screen、Window和Window.screen。

state : Qt::ApplicationState [只读]

此属性表示应用程序的当前状态。

Timer {
    interval: 1000; repeat: true
    active: Application.state === Qt.Qt.ApplicationActive
    onTriggered: imageFetcher.fetchLatestImages()
}

styleHints : StyleHints [只读]

styleHints属性提供平台特定的样式提示和设置。有关详细信息，请参阅QStyleHints文档。

以下示例使用styleHints来确定项目是否应在鼠标点击或触摸释放时获得焦点

import QtQuick

MouseArea {
    id: button

    onPressed: {
        if (!Application.styleHints.setFocusOnTouchRelease)
            button.forceActiveFocus()
    }
    onReleased: {
        if (Application.styleHints.setFocusOnTouchRelease)
            button.forceActiveFocus()
    }
}

supportsMultipleWindows : bool [只读]

如果平台支持多个窗口则返回true。例如，某些嵌入式平台不支持多个窗口。

version : QString

这是在QCoreApplication实例上设置的程序版本。可以通过写入此属性来设置程序版本。

信号文档

aboutToQuit()

当应用程序即将退出主事件循环时发射此信号。如果应用程序需要进行最后清洗，则此信号特别有用。在这种状态下，用户互操作是不可能的。有关更多信息，请参阅Window.closing。

注意：相应的处理程序是onAboutToQuit。

另请参阅QCoreApplication::aboutToQuit。