En esta página

BorderImageMesh QML Type

Define una malla con vértices dispuestos como los de un BorderImage. Más...

Import Statement: import QtQuick

Propiedades

Descripción detallada

BorderImageMesh proporciona capacidades similares a BorderImage a un ShaderEffect sin necesidad de un ShaderEffectSource potencialmente costoso.

Los siguientes 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 BorderImageMesh suele estar mejor optimizada.

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, como se muestra a continuación:

Cada línea de borde (izquierda, derecha, superior e inferior) especifica un desplazamiento en píxeles desde el borde respectivo 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 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.

  • BorderImageEstirar - Escala la imagen para ajustarla al área disponible.
  • BorderImageRepetir - Mosaico de la imagen hasta que no hay más espacio. Puede recortar la última imagen.
  • BorderImageRedondear - Como Repetir, pero reduce la escala de las imágenes para garantizar que la última imagen no se recorta.

El modo de mosaico por defecto para cada propiedad es BorderImage.Stretch.

size : size

El tamaño base de la malla. Suele corresponder a la dirección sourceSize de la imagen utilizada por 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.