Overlay QML Type

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

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Angehängte Eigenschaften

• modal : Component
• modeless : Component
• overlay : Overlay

Angehängte Signale

• pressed()
• released()

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 Eigenschaft Attached

Overlay.modal : Component

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 mit jedem Popup verbunden 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, die als visuelles Element verwendet wird und die Hintergrunddimmung für modelllose Popups implementiert. Sie wird für sichtbare Dimming-Popups erstellt und darunter 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 zum angehängten Signal

pressed()

Dieses angehängte Signal wird ausgesendet, wenn der Benutzer auf das Overlay drückt, während ein Popup sichtbar ist.

Das Signal kann an ein beliebiges 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.

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.