En esta página

Rectangle QML Type

Dibuja un rectángulo relleno con un borde opcional. Más...

Import Statement: import QtQuick
Inherits:

Item

Inherited By:

DebugView

Propiedades

Descripción detallada

Los elementos rectangulares se utilizan para rellenar áreas con colores lisos o degradados, y/o para crear un borde rectangular.

Apariencia

Cada elemento «Rectángulo» se rellena con un color sólido, especificado mediante la propiedad « color », o con un degradado, definido mediante un tipo de degradado y configurado mediante la propiedad « gradient ». Si se especifican tanto un color como un degradado, se utiliza el degradado.

Se puede añadir un borde opcional a un rectángulo con su propio color y grosor configurando las propiedades ` border.color ` y ` border.width `. Establezca el color en «transparente» para pintar un borde sin color de relleno.

También puede crear rectángulos redondeados utilizando la propiedad ` radius `. Dado que esto introduce bordes curvos en las esquinas de un rectángulo, puede ser conveniente establecer la propiedad ` Item::antialiasing ` para mejorar su aspecto. Para establecer los radios individualmente para las diferentes esquinas, puede utilizar las propiedades ` topLeftRadius`, ` topRightRadius`, ` bottomLeftRadius ` y ` bottomRightRadius`.

Ejemplo de uso

Rectángulo rojo con esquinas redondeadas y borde negro

El siguiente ejemplo muestra los efectos de algunas de las propiedades más comunes en un elemento Rectangle, que en este caso se utiliza para crear un cuadrado:

import QtQuick

Rectangle {
    width: 100
    height: 100
    color: "red"
    border.color: "black"
    border.width: 5
    radius: 10
}

Rendimiento

El uso de la propiedad « Item::antialiasing » mejora el aspecto de un rectángulo redondeado a costa del rendimiento de la representación. Se recomienda desactivar esta propiedad para los rectángulos en movimiento y activarla únicamente cuando estén quietos.

Véase también Image.

Documentación de la propiedad

antialiasing : bool

Se utiliza para determinar si el rectángulo debe aplicar suavizado o no. El suavizado proporciona información sobre las implicaciones de esta propiedad en el rendimiento.

El valor por defecto es «true» para los rectángulos con radio y «false» en los demás casos.

border group

border.color : color

border.pixelAligned : bool

border.width : int

El grosor y el color utilizados para dibujar el borde del rectángulo.

Un ancho de 1 crea una línea fina. Para que no haya línea, utiliza un ancho de 0 o un color transparente.

Nota: El ancho del borde del rectángulo no afecta a la geometría del propio rectángulo ni a su posición respecto a otros elementos si se utilizan anclajes.

El borde se representa dentro de los límites del rectángulo.

Si el valor de « pixelAligned » es « true » (el valor predeterminado), el ancho del borde renderizado se redondea a un número entero de píxeles, tras el escalado según la relación de píxeles del dispositivo. Si se establece « pixelAligned » en « false », se permitirán anchos de borde fraccionarios, lo que puede resultar conveniente cuando está activada la opción « antialiasing ».

bottomLeftRadius : real [since 6.7]

Esta propiedad define el radio que se utiliza para dibujar la esquina inferior izquierda.

Si no se establece el valor de `bottomLeftRadius`, se utilizará en su lugar ` radius `. Si `bottomLeftRadius` es cero, la esquina será aguda.

Esta propiedad se introdujo en Qt 6.7.

Véase también « radius », « topLeftRadius », « topRightRadius » y « bottomRightRadius ».

bottomRightRadius : real [since 6.7]

Esta propiedad especifica el radio que se utiliza para dibujar la esquina inferior derecha.

Si no se establece «bottomRightRadius», se utilizará en su lugar « radius ». Si «bottomRightRadius» es cero, la esquina será aguda.

Esta propiedad se introdujo en Qt 6.7.

Véase también « radius », « topLeftRadius », « topRightRadius » y « bottomLeftRadius ».

color : color

Esta propiedad determina el color que se utiliza para rellenar el rectángulo.

El color predeterminado es el blanco.

Rectángulos verdes y azules que ilustran las propiedades del color

El siguiente ejemplo muestra rectángulos con colores especificados mediante notación hexadecimal y notación de colores con nombre:

Rectangle {
    color: "#00B000"
    width: 80; height: 80
}

Rectangle {
    color: "steelblue"
    y: 100; width: 80; height: 80
}

Si se especifican tanto un degradado como un color, se utilizará el degradado.

Véase también gradient.

gradient : var

El degradado que se va a utilizar para rellenar el rectángulo.

Esta propiedad permite crear degradados simples verticales u horizontales. Se pueden crear otros degradados añadiendo rotación al rectángulo.

Cuatro rectángulos que muestran variaciones de degradado

Rectangle {
    width: 80; height: 80
    color: "lightsteelblue"
}

Rectangle {
    width: 80; height: 80
    gradient: Gradient {
        GradientStop { position: 0.0; color: "lightsteelblue" }
        GradientStop { position: 1.0; color: "blue" }
    }
}

Rectangle {
    width: 80; height: 80
    gradient: Gradient {
        orientation: Gradient.Horizontal
        GradientStop { position: 0.0; color: "lightsteelblue" }
        GradientStop { position: 1.0; color: "blue" }
    }
}

Rectangle {
    width: 80; height: 80
    rotation: 90
    gradient: Gradient {
        GradientStop { position: 0.0; color: "lightsteelblue" }
        GradientStop { position: 1.0; color: "blue" }
    }
}

La propiedad también admite preajustes de degradado de QGradient::Preset. Sin embargo, hay que tener en cuenta que, dado que Rectangle solo admite degradados simples verticales u horizontales, cualquier preajuste con un ángulo no compatible se convertirá en la representación más cercana.

Rectangle {
    width: 80; height: 80
    gradient: Gradient.NightFade
}

Rectangle {
    width: 80; height: 80
    gradient: "SunnyMorning"
}

Si se especifican tanto un degradado como un color, se utilizará el degradado.

Véase también Gradient y color.

radius : real

Esta propiedad define el radio de las esquinas que se utiliza para dibujar un rectángulo redondeado.

Si el radio es distinto de cero, el rectángulo se dibujará como un rectángulo redondeado; de lo contrario, se dibujará como un rectángulo normal. También se pueden establecer radios de esquina individuales (véase más abajo). Estos valores anularán el radio. Si no se establecen (estableciéndolos en ` undefined`), se utilizará el radio en su lugar.

Véase también « topLeftRadius », « topRightRadius », « bottomLeftRadius » y « bottomRightRadius ».

topLeftRadius : real [since 6.7]

Esta propiedad define el radio que se utiliza para dibujar la esquina superior izquierda.

Si no se establece el valor de `topLeftRadius`, se utilizará en su lugar ` radius `. Si `topLeftRadius` es cero, la esquina será afilada.

Esta propiedad se introdujo en Qt 6.7.

Véase también « radius », « topRightRadius », « bottomLeftRadius » y « bottomRightRadius ».

topRightRadius : real [since 6.7]

Esta propiedad contiene el radio que se utiliza para dibujar la esquina superior derecha.

Si no se establece el valor de `topRightRadius`, se utilizará en su lugar ` radius `. Si `topRightRadius` es cero, la esquina será puntiaguda.

Esta propiedad se introdujo en Qt 6.7.

Véase también « radius », « topLeftRadius », « bottomLeftRadius » y « bottomRightRadius ».

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