Back to Qt.io
Contact Us Blog Download Qt

Overlay QML Type

用于弹出窗口的覆盖层。更多

Import Statement: import QtQuick.Controls
Inherits:

Item

附加属性

附加信号

详细说明

覆盖层为弹出窗口提供了一个层，确保弹出窗口显示在其他内容之上，并在modal 或dimmed 弹出窗口可见时背景变暗。

覆盖层是一个覆盖整个窗口的普通项。它可以作为可视化父项，在场景坐标中定位弹出窗口。

下面的示例使用所附的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 : Component

该附加属性包含一个组件，可用作实现无模式弹出窗口背景调光的可视化项目。它是为可视调光弹出窗口创建的，并堆叠在可视调光弹出窗口下方。

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

例如，要更改无模型弹出窗口的背景调光颜色，可使用以下代码：

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

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

另请参阅 Popup::dim 。


Overlay.overlay : Overlay [read-only]

该附加属性用于保存窗口覆盖项。

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


附加信号文档

pressed()

当用户在弹出窗口可见时按下叠加器时，就会发出该附加信号。

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

注意： 从 Qt 6.9 开始，右键点击不会发出该信号。请使用覆盖层的父级TapHandler 代替。

注： 相应的处理程序是onPressed 。


released()

当用户在弹出窗口可见时释放覆盖时，将发出此附加信号。

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

注意： 从 Qt 6.9 开始，右键点击不会发出该信号。请使用覆盖层的父级TapHandler 代替。

注： 相应的处理程序是onReleased 。


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.