Overlay QML Type

Eine Fensterüberlagerung 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“ stellt eine Ebene für Popups bereit und stellt sicher, dass Popups über anderen Inhalten angezeigt werden und der Hintergrund abgeblendet wird, wenn ein Popup vom Typ „ modal “ oder „ dimmed “ sichtbar ist.

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

Im folgenden Beispiel wird die angehängte Eigenschaft „ Overlay.overlay “ verwendet, um ein Popup in der Mitte des Fensters zu positionieren, unabhängig von 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 zu angehängten Eigenschaften

Overlay.modal : Component [attached]

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

Die Eigenschaft kann an jedes beliebige Popup angehängt werden.

Um beispielsweise die Farbe der Hintergrundabdunkelung 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 [attached]

Diese angehängte Eigenschaft enthält eine Komponente, die als visuelles Element dient und die Hintergrundabdunkelung für modallose Popups implementiert. Sie wird für sichtbare, abgedunkelte Popups erstellt und unter diesen angeordnet.

Die Eigenschaft kann an jedes beliebige Popup angehängt werden.

Um beispielsweise die Farbe der Hintergrundabdunkelung für ein modusfreies 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 attached]

Diese zugeordnete 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 “, sofern sich das Element oder Popup nicht in einem Fenster befindet.

Dokumentation zu „Attached Signal“

[attached] pressed()

Dieses angehängte Signal wird ausgelöst, wenn der Benutzer auf das Overlay klickt, während ein Popup-Fenster 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 ausgelöst, wenn sich das Element oder das Popup in einem Fenster befindet.

[attached] released()

Dieses angehängte Signal wird ausgelöst, wenn der Benutzer das Overlay loslässt, während ein Popup sichtbar ist.

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