Back to Qt.io
Contact Us Blog Download Qt

Overlay QML Type

Ein Fenster-Overlay für Popups. Mehr...

Import Statement: import QtQuick.Controls
Inherits:

Item

Angehängte Eigenschaften

Angehängte Signale

Ausführliche Beschreibung

Overlay bietet eine Ebene für Popups, die sicherstellt, dass Popups über anderen Inhalten angezeigt werden und dass der Hintergrund gedimmt wird, wenn ein modal oder dimmed Popup sichtbar ist.

Das Overlay ist ein gewöhnliches Element, das das gesamte Fenster abdeckt. Es kann als visuelles Elternteil verwendet werden, um ein Popup in Szenenkoordinaten zu positionieren.

Das folgende Beispiel verwendet die angehängte Eigenschaft Overlay.overlay, um ein Popup in der Mitte des Fensters zu positionieren, ungeachtet der Position der Schaltfläche, die das Popup öffnet:

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
    }
}

Siehe auch ApplicationWindow.

Dokumentation der angehängten Eigenschaft

Diese angehängte Eigenschaft enthält eine Komponente, die als visuelles Element verwendet wird und die Hintergrunddimmung für modale Popups implementiert. Sie wird für sichtbare modale Popups erstellt und unter diesen gestapelt.

Die Eigenschaft kann an jedes Popup angehängt werden.

Um zum Beispiel die Farbe der Hintergrunddimmung für ein modales Popup zu ändern, kann der folgende Code verwendet werden:

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

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

Siehe auch Popup::modal.


Overlay.modeless : Component

Diese angehängte Eigenschaft enthält eine Komponente zur Verwendung als visuelles Element, das die Hintergrunddimmung für modallose Popups implementiert. Sie wird für sichtbare Dimming-Popups erstellt und unter diesen gestapelt.

Die Eigenschaft kann mit jedem Popup verbunden werden.

Um zum Beispiel die Farbe der Hintergrunddimmung für ein modellloses Popup zu ändern, kann der folgende Code verwendet werden:

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

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

Siehe auch Popup::dim.


Overlay.overlay : Overlay [read-only]

Diese angehängte Eigenschaft enthält das Fenster-Overlay-Element.

Die Eigenschaft kann an jedes Element, Popup oder Fenster angehängt werden. Wenn sie an ein Element oder ein Popup angehängt ist, lautet der Wert null, wenn sich das Element oder Popup nicht in einem Fenster befindet.


Dokumentation des angehängten Signals

pressed()

Dieses angehängte Signal wird ausgegeben, wenn das Overlay vom Benutzer gedrückt wird, während ein Popup sichtbar ist.

Das Signal kann an jedes Element, Popup oder Fenster angehängt werden. Wenn es an ein Element oder ein Popup angehängt ist, wird das Signal nur ausgegeben, wenn sich das Element oder Popup in einem Fenster befindet.

Hinweis: Der entsprechende Handler ist onPressed.


released()

Dieses angehängte Signal wird ausgegeben, wenn das Overlay vom Benutzer losgelassen wird, während ein Popup sichtbar ist.

Das Signal kann an jedes Element, Popup oder Fenster angehängt werden. Wenn es an ein Element oder ein Popup angehängt ist, wird das Signal nur ausgegeben, wenn sich das Element oder Popup in einem Fenster befindet.

Hinweis: Der entsprechende Handler ist 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.