En esta página

BorderImageMesh QML Type

Define una malla cuyos vértices están dispuestos como los de una « BorderImage ». Más información...

Import Statement: import QtQuick

Propiedades

Descripción detallada

BorderImageMesh proporciona capacidades similares a las de « BorderImage » a un « ShaderEffect » sin necesidad de un « ShaderEffectSource », que puede resultar costoso.

Las siguientes opciones son funcionalmente equivalentes:

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

Sin embargo, la versión de BorderImageMesh suele poder optimizarse mejor.

Documentación de propiedades

border group

border.bottom : int

border.left : int

border.right : int

border.top : int

Las 4 líneas de borde (2 horizontales y 2 verticales) dividen la imagen en 9 secciones, tal y como se muestra a continuación:

Rectángulo rojo redondeado dividido en 9 regiones numeradas por líneas de borde discontinuas

Cada línea de borde (izquierda, derecha, superior e inferior) especifica un desplazamiento en píxeles desde el borde correspondiente de la malla. Por defecto, cada línea de borde tiene un valor de 0.

Por ejemplo, la siguiente definición establece la línea inferior a 10 píxeles por encima de la parte inferior de la malla:

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

horizontalTileMode : enumeration

verticalTileMode : enumeration

Esta propiedad describe cómo repetir o estirar las partes centrales de una imagen.

  • BorderImage.Estirar: escala la imagen para que se ajuste al área disponible.
  • BorderImage.Repetir: repite la imagen hasta que no quede más espacio. Puede recortar la última imagen.
  • BorderImage.Redondear: igual que «Repetir», pero reduce el tamaño de las imágenes para garantizar que la última imagen no se recorte.

El modo de mosaico predeterminado para cada propiedad es BorderImage.Stretch.

size : size

El tamaño base de la malla. Por lo general, esto se corresponde con el sourceSize de la imagen que utiliza el 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.