Overlay QML Type

Une fenêtre superposée pour les fenêtres contextuelles. Plus d'informations...

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

Propriétés attachées

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

Signaux attachés

• pressed()
• released()

Description détaillée

La superposition fournit une couche pour les fenêtres contextuelles, garantissant que les fenêtres contextuelles sont affichées au-dessus des autres contenus et que l'arrière-plan est atténué lorsqu'une fenêtre contextuelle modal ou dimmed est visible.

Le recouvrement est un élément ordinaire qui couvre la totalité 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é attachée Overlay.overlay pour positionner une fenêtre contextuelle au centre de la fenêtre, malgré la position du bouton qui ouvre la fenêtre contextuelle :

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 aussi ApplicationWindow.

Documentation sur la propriété attached

Overlay.modal : Component

Cette propriété jointe contient un composant à utiliser comme élément visuel qui met en œuvre l'obscurcissement de l'arrière-plan pour les fenêtres contextuelles modales. Il est créé pour les fenêtres pop-up modales visibles et empilé sous celles-ci.

La propriété peut être attachée à n'importe quelle fenêtre contextuelle.

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

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

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

Voir aussi Popup::modal.

Overlay.modeless : Component

Cette propriété jointe contient un composant à utiliser comme élément visuel qui met en œuvre la gradation de l'arrière-plan pour les fenêtres contextuelles sans modèle. Il est créé pour les fenêtres contextuelles à gradation visible et empilé sous celles-ci.

La propriété peut être attachée à n'importe quelle fenêtre contextuelle.

Par exemple, pour modifier la couleur de l'obscurcissement de l'arrière-plan d'une fenêtre contextuelle sans modèle, on peut utiliser le code suivant :

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

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

Voir aussi Popup::dim.

Overlay.overlay : Overlay [read-only]

Cette propriété jointe contient l'élément de la fenêtre superposée.

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

Documentation sur le signal attaché

pressed()

Ce signal attaché est émis lorsque l'utilisateur appuie sur le recouvrement alors qu'une fenêtre contextuelle est visible.

Le signal peut être attaché à n'importe quel élément, popup ou fenêtre. Lorsqu'il est attaché à 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.

released()

Ce signal attaché est émis lorsque l'utilisateur relâche la superposition alors qu'une fenêtre contextuelle est visible.

Le signal peut être attaché à n'importe quel élément, popup ou fenêtre. Lorsqu'il est attaché à 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.