叠加QML类型

弹出窗口的窗口叠加层。更多...

导入声明	import QtQuick.Controls
继承	Item

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

附加属性

modal : 组件
modeless : 组件
overlay : 堆叠

附加信号

压下()
释放()

详细信息

叠加提供了一个用于弹出窗口的层，确保弹出窗口位于其他内容之上，并在出现一个模式对话框或暗淡对话框时变暗。

叠加是一个普通的Item，覆盖整个窗口。它可以用作场景坐标中弹出窗口的视觉父对象。

以下示例使用附加的Overlay.overlay属性在窗口中心定位一个弹出窗口，无论打开弹出窗口的按钮位置如何

Button {
    onClicked: popup.open()

    Popup {
        id: popup

        parent: Overlay.overlay

        x: Math.round((parent.width - width) / 2)
        y: Math.round((parent.height - height) / 2)
        width: 100
        height: 100
    }
}

另请参阅ApplicationWindow。

附加属性文档

此附加属性保留一个组件以用作实现模式对话框背景变暗的视觉项。它为可见模式对话框创建，并堆叠在可见模式对话框下方。

该属性可以附加到任何弹出窗口。

例如，要更改模式对话框的背景变暗的颜色，可以使用以下代码

Popup {
    id: popup
    width: 400
    height: 400
    modal: true
    visible: true

    Overlay.modal: Rectangle {
        color: "#aacfdbe7"
    }
}

另请参阅Popup::modal。

Overlay.modeless : 组件

此附加属性保留一个组件以用作实现无模式对话框背景变暗的视觉项。它为可见无模式对话框创建，并堆叠在可见无模式对话框下方。

该属性可以附加到任何弹出窗口。

例如，要更改无模式对话框的背景变暗的颜色，可以使用以下代码

Popup {
    id: popup
    width: 400
    height: 400
    dim: true
    visible: true

    Overlay.modeless: Rectangle {
        color: "#aacfdbe7"
    }
}

另请参阅Popup::dim。

Overlay.overlay : Overlay [只读]

此附加属性保留了窗口叠加项。

该属性可以附加到任何项、弹出窗口或窗口。当附加到项或弹出窗口时，如果该项或弹出窗口不在窗口中，则值是null。

附加信号文档

压下()

当叠加被用户压下且弹出窗口可见时，发出此附加信号。

信号可以附加到任何项目、弹出窗口或窗口。当附加到项目或弹出窗口时，只有当项目或弹出窗口位于窗口中时，信号才会发出。

注意：相应的处理器是 onPressed。

释放()

当用户在弹出窗口可见时释放叠加层时，该附加信号会发出。

信号可以附加到任何项目、弹出窗口或窗口。当附加到项目或弹出窗口时，只有当项目或弹出窗口位于窗口中时，信号才会发出。

注意：相应的处理器是 onReleased。