Sur cette page

BorderImageMesh QML Type

Définit un maillage dont les sommets sont disposés comme ceux d'un BorderImage. Plus...

Import Statement: import QtQuick

Propriétés

Description détaillée

BorderImageMesh fournit des capacités similaires à BorderImage à une ShaderEffect sans avoir besoin d'une ShaderEffectSource potentiellement coûteuse.

Les versions suivantes sont fonctionnellement équivalentes :

BorderImage {
    id: borderImage
    border {
        left: 10
        right: 10
        top: 10
        bottom: 10
    }
    source: "myImage.png"
    visible: false
}
ShaderEffectSource {
    id: effectSource
    sourceItem: borderImage
    visible: false
}
ShaderEffect {
    property var source: effectSource
    ...
}
Image {
    id: image
    source: "myImage.png"
    visible: false
}
ShaderEffect {
    property var source: image
    mesh: BorderImageMesh {
        border {
            left: 10
            right: 10
            top: 10
            bottom: 10
        }
        size: image.sourceSize
    }
    ...
}

Mais la version BorderImageMesh peut généralement être mieux optimisée.

Documentation sur les propriétés

border group

border.bottom : int

border.left : int

border.right : int

border.top : int

Les 4 lignes de bordure (2 horizontales et 2 verticales) divisent l'image en 9 sections, comme indiqué ci-dessous :

Chaque ligne de bordure (gauche, droite, haut et bas) spécifie un décalage en pixels par rapport au bord respectif du maillage. Par défaut, chaque ligne de bordure a une valeur de 0.

Par exemple, la définition suivante place la ligne inférieure à 10 pixels du bas du maillage :

BorderImageMesh {
    border.bottom: 10
    // ...
}

horizontalTileMode : enumeration

verticalTileMode : enumeration

Cette propriété décrit comment répéter ou étirer les parties centrales d'une image.

  • BorderImage.Stretch - Met l'image à l'échelle pour qu'elle s'adapte à la zone disponible.
  • BorderImage.Repeat - Répéter l'image jusqu'à ce qu'il n'y ait plus d'espace. La dernière image peut être recadrée.
  • BorderImage.Round - Comme Repeat, mais réduit la taille des images pour éviter que la dernière image ne soit rognée.

Le mode de mosaïque par défaut pour chaque propriété est BorderImage.Stretch.

size : size

La taille de base du maillage. Elle correspond généralement à l'adresse sourceSize de l'image utilisée par ShaderEffect.

© 2026 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.