ApplicationManagerWindow QML 类型

应用程序的窗口根元素。更多信息...

导入声明	import QtApplicationManager.Application 2.0
继承	Window

包括继承成员在内的所有成员列表

属性

active : bool
activeFocusItem : Item
backingObject : QtObject
color : color
contentItem : Item
height : int
maximumHeight : int
maximumWidth : int
minimumHeight : int
minimumWidth : int
opacity : real
singleProcess : bool
title : string
visibility : QWindow::Visibility
visible : bool
width : int
x : int
y : int

附加属性

active : bool
activeFocusItem : Item
backingObject : QtObject
contentItem : Item
height : int
visibility : QWindow::Visibility
width : int
window : ApplicationManagerWindow

信号

void afterAnimating()
关闭(CloseEvent close)
void 帧交换()
void 场景图错误(QQuickWindow::SceneGraphError error, string message)
窗口属性更改(string name, var value)

方法

关闭()
void 隐藏()
void 设置窗口属性(string name, var &value)
void 显示()
void 全屏显示()
void 最大化()
void 最小化()
void 正常显示()
object 窗口属性集合()
var 窗口属性(string name)

详细描述

此 QML 项目可以用作您 QML 应用程序的主项目。这样做，您可以启用应用程序在单进程（EGL 全屏、桌面）和多进程（Wayland）模式下使用。为了实现这一点，此类不是直接从 QQuickWindow 继承而来，而是从 QObject 继承而来。

API 与 Window 的 API 非常相似，但缺少一些内容，这些内容对于嵌入式用例不适用或在单进程情况下无法支持。如果您需要访问这些内容，您仍然可以通过 backingObject 属性进行访问。通过检查 singleProcess 属性来查看您是否处于单进程模式以及实际 backingObject 是否是一个 Item 或一个 Window。

与 Window 不同，ApplicationManagerWindow 默认是可见的。

更多详细信息请参阅有关主元素和应用程序窗口的章节。

注意：在版本 6.7 之前，此类在多进程模式下继承了 Window，在单进程模式下继承了 QtObject，但这使得在此类上无法使用 qml 工具。QML API 中没有 "修订" 标记，也没有在重新实现此类后的文档中的 "自" 标记，因为它们可能对应旧实现中哪一个是不明确的。

此项目的 QML 导入语句是

import QtApplicationManager.Application

导入后，可以像这样创建 QML 项

import QtQuick
import QtApplicationManager.Application

ApplicationManagerWindow {
    Text {
        text: ApplicationInterface.applicationId
    }
}

属性文档

高度 : int

宽度 : int

x : int

y : int

定义窗口的位置和大小。

（x，y）的位置相对于合成器的屏幕。

minimumHeight : int

minimumWidth : int

定义窗口的最小尺寸。

这是给合成器的一个提示，防止窗口尺寸小于指定的宽度和高度。

maximumHeight : int

maximumWidth : int

定义窗口的最大尺寸。

这是给合成器的一个提示，防止窗口尺寸大于指定的宽度和高度。

active : bool

窗口的活动状态。

activeFocusItem : Item

当前具有活动聚焦的项，如果没有具有活动聚焦的项，则为 null。

backingObject : QtObject [只读]

此属性包含此窗口的背衬对象：在单进程模式下，这是一个作为 Item 的容器来动作 contentItem，但在多进程模式下，它是实际的 Window 实例。

color : color

窗口的背景颜色。

设置此属性比使用单独的 Rectangle 更有效。

注意：从版本 6.7 开始，如果使用 alpha 通道，则它需要为线性 alpha。在 6.7 之前，它需要为预乘 alpha（这是 Window QML 类型仍然期望的），在多进程模式和单进程模式下为线性 alpha。

contentItem : Item [只读]

场景的无形根项。

opacity : real

窗口的不透明度。

1.0 或以上的值被视为完全不透明，而 0.0 或以下的值被视为完全透明。介于两者之间的值代表两种极端之间的不同透明度级别。

默认值为 1.0。

singleProcess : bool [只读]

当应用程序以单进程模式运行时，此属性为 true，当它以多进程模式运行时为 false。

另请参阅：ApplicationManager::singleProcess。

title : string

窗口在窗口系统中的标题。

visibility : QWindow::Visibility

窗口的屏幕占用状态。

可见性是窗口是否显示在窗口系统中的正常、最小化、最大化、全屏或隐藏状态。

有关更多详细信息，请参阅 Window::visibility。在单进程模式下，不支持最小化、最大化和全屏状态，并直接映射为正常状态。

visible : bool

窗口是否在屏幕上可见。

将可见性设置为 false 等于将 visibility 设置为 Hidden。

另请参阅：visibility。

附加属性文档

ApplicationManagerWindow.height : int [只读]

ApplicationManagerWindow.width : int [只读]

这些附加属性保存了对项窗口的大小。可以将ApplicationManagerWindow附加属性附加到任何项。

ApplicationManagerWindow.active : bool

此附加属性表示窗口是否为活动状态。可以将ApplicationManagerWindow附加属性附加到任何项。

ApplicationManagerWindow.activeFocusItem : Item [只读]

此附加属性保存了当前具有活动焦点的项或如果没有任何项具有活动焦点则为null。可以将ApplicationManagerWindow附加属性附加到任何项。

ApplicationManagerWindow.backingObject : QtObject [只读]

此附加属性保存ApplicationManagerWindow的backingObject。

另请参阅 backingObject。

ApplicationManagerWindow.contentItem : Item [只读]

此附加属性保存场景的无形根项或如果该项不在窗口中则为null。可以将ApplicationManagerWindow附加属性附加到任何项。

ApplicationManagerWindow.visibility : QWindow::Visibility [只读]

此附加属性表示窗口是否在窗口系统以正常、最小化、最大化、全屏或隐藏方式显示。可以将在任何ApplicationManagerWindow中显示的项。如果项不在任何ApplicationManagerWindow中显示，则值将为隐藏。

另请参阅 visible 和 visibility。

ApplicationManagerWindow.window : ApplicationManagerWindow [只读]

此附加属性保存项的ApplicationManagerWindow。可以将ApplicationManagerWindow附加属性附加到任何项。

信号文档

void afterAnimating()

此信号从底层的QQuickWindow对象转发：在多进程模式下是此对象的对应QQuickWindow，或在单进程模式下是系统UI的QQuickWindow。

注意： 对应的处理程序是onAfterAnimating。

closing(CloseEvent close)

当用户尝试关闭窗口时，会发出此信号。

该信号包含一个 close 字段。默认情况下，close.accepted 属性为 true，允许窗口关闭，但您可以实现一个 onClosing 处理器并设置 close.accepted = false 在窗口关闭之前执行其他操作。

注意：对应的处理器是 onClosing。

void frameSwapped()

此信号从底层的QQuickWindow对象转发：在多进程模式下是此对象的对应QQuickWindow，或在单进程模式下是系统UI的QQuickWindow。

注意：对应的处理器是 onFrameSwapped。

参见：QQuickWindow::frameSwapped()。

void sceneGraphError(QQuickWindow::SceneGraphError error, string message)

此信号及其参数 error 和 message 从底层 QQuickWindow 对象转发：在多进程模式下，对应此对象的 QQuickWindow，或者在单进程模式下是系统 UI 的 QQuickWindow。

注意：对应的处理器是 onSceneGraphError。

参见：QQuickWindow::sceneGraphError。

windowPropertyChanged(string name, var value)

报告了此应用程序窗口的属性变化，属性名为 name，新值为 value。

注意：对应的处理器是 onWindowPropertyChanged。

参见：setWindowProperty。

方法文档

关闭()

关闭窗口。

当调用此方法时，将发出 closing 信号。如果没有处理器，或者处理器没有撤销关闭权限，则窗口将随后关闭。如果 QGuiApplication::quitOnLastWindowClosed 属性为 true，并且没有其他窗口打开，则应用程序将退出。

void hide()

隐藏窗口。

相当于将 visible 设置为 false 或 visibility 设置为隐藏。

参见：show。

void setWindowProperty(string name, var &value)

将此应用程序窗口的共享属性 name 设置为给定的 value。

这些属性在系统 UI 和客户端应用程序之间共享：在单进程模式下通过一个 QVariantMap，在多进程模式下通过 Qt 的扩展表面 Wayland 扩展。客户端方面的更改通过 windowPropertyChanged 信号发出。

有关服务器端 API，请参见 WindowManager。

注意：在监听系统 UI 端 Wayland 客户端属性变化时，请注意底层 Wayland 协议的异步特性。

参见：windowProperty，windowProperties，以及 windowPropertyChanged。

void show()

显示窗口。

等同于将 visible 属性设置为 true。

另请参阅hide() 和 visibility。

void showFullScreen()

在多进程模式下，此调用将传递到底层的 QWindow 对象。单进程模式不支持窗口状态，因此此调用映射为简单的 show()。

另请参阅QWindow::showFullScreen。

void showMaximized()

在多进程模式下，此调用将传递到底层的 QWindow 对象。单进程模式不支持窗口状态，因此此调用映射为简单的 show()。

另请参阅QWindow::showMaximized。

void showMinimized()

在多进程模式下，此调用将传递到底层的 QWindow 对象。单进程模式不支持窗口状态，因此此调用映射为简单的 show()。

另请参阅QWindow::showMinimized。

void showNormal()

在多进程模式下，此调用将传递到底层的 QWindow 对象。单进程模式不支持窗口状态，因此此调用映射为简单的 show()。

另请参阅QWindow::showNormal。

object windowProperties()

返回包含此应用程序窗口所有共享属性的对象。

参见：setWindowProperty。

var windowProperty(string name)

返回由 name 标识的此应用程序窗口的共享属性值。

参见：setWindowProperty。