Overlay QML Type

Une fenêtre superposée pour les fenêtres contextuelles. En savoir plus...

• Liste de tous les membres, y compris les membres hérités

Propriétés associées

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

Signaux associés

• pressed()
• released()

Description détaillée

La fonction « Overlay » fournit un calque pour les fenêtres contextuelles, garantissant que celles-ci s'affichent par-dessus les autres contenus et que l'arrière-plan soit assombri lorsqu'une fenêtre contextuelle de type « modal » ou « dimmed » est visible.

L'overlay est un élément (Item) ordinaire qui recouvre l'intégralité de la fenêtre. Il peut être utilisé comme parent visuel pour positionner une fenêtre contextuelle dans les coordonnées de la scène.

L'exemple suivant utilise la propriété Overlay.overlay associée pour positionner une fenêtre contextuelle au centre de la fenêtre, quelle que soit la position du bouton qui l'ouvre :

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

Voir également ApplicationWindow.

Documentation sur les propriétés associées

Overlay.modal : Component [attached]

Cette propriété associée contient un composant destiné à servir d'élément visuel qui permet de griser l'arrière-plan des fenêtres modales. Elle est créée pour les fenêtres modales visibles et s'affiche en dessous de celles-ci.

Cette propriété peut être associée à n'importe quelle fenêtre contextuelle.

Par exemple, pour modifier la couleur de l'assombrissement de l'arrière-plan d'une fenêtre contextuelle modale, vous pouvez utiliser le code suivant :

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

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

Voir également Popup::modal.

Overlay.modeless : Component [attached]

Cette propriété associée contient un composant destiné à être utilisé comme élément visuel permettant de griser l'arrière-plan des fenêtres contextuelles non modales. Elle est créée pour les fenêtres contextuelles à effet de grisé visibles et s'affiche en dessous de celles-ci.

Cette propriété peut être associée à n'importe quelle fenêtre contextuelle.

Par exemple, pour modifier la couleur de l'assombrissement de l'arrière-plan d'une fenêtre contextuelle non modale, vous pouvez utiliser le code suivant :

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

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

Voir également Popup::dim.

Overlay.overlay : Overlay [read-only attached]

Cette propriété associée contient l'élément de superposition de fenêtre.

Cette propriété peut être associée à n'importe quel élément, fenêtre contextuelle ou fenêtre. Lorsqu'elle est associée à un élément ou à une fenêtre contextuelle, sa valeur est « null » si l'élément ou la fenêtre contextuelle ne se trouve pas dans une fenêtre.

Documentation sur le signal « Attached »

[attached] pressed()

Ce signal associé est émis lorsque l'utilisateur appuie sur la superposition alors qu'une fenêtre contextuelle est visible.

Ce signal peut être associé à n'importe quel élément, fenêtre contextuelle ou fenêtre. Lorsqu'il est associé à un élément ou à une fenêtre contextuelle, le signal n'est émis que si l'élément ou la fenêtre contextuelle se trouve dans une fenêtre.

[attached] released()

Ce signal associé est émis lorsque l'utilisateur ferme la superposition alors qu'une fenêtre contextuelle est visible.

Ce signal peut être associé à n'importe quel élément, fenêtre contextuelle ou fenêtre. Lorsqu'il est associé à un élément ou à une fenêtre contextuelle, le signal n'est émis que si l'élément ou la fenêtre contextuelle se trouve dans une fenêtre.