En esta página

RectangleShape QML Type

Un rectángulo rellenado con un borde opcional. Más...

Import Statement: import QtQuick.Shapes.DesignHelpers 6.12
Since: QtQuick 6.10

Propiedades

Descripción detallada

RectangleShape se utiliza para rellenar áreas con un color sólido o degradados y para crear un borde rectangular.

Cada elemento Rectangle se pinta utilizando un color de relleno sólido, especificado mediante la propiedad « fillColor », o un degradado, definido mediante uno de los subtipos « ShapeGradient » y establecido 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 « strokeColor » y « strokeWidth ». Si se establece el color en « transparent », se crea un borde sin color de relleno.

Se pueden dibujar rectángulos redondeados utilizando la propiedad « radius ». El radio también se puede especificar por separado para cada esquina. Además, se puede aplicar la propiedad « bevel » a cualquier esquina para recortarla de forma nítida.

El valor predeterminado de RectangleShape para QtQuick.Shapes::Shape::preferredRendererType es Shape.CurveRenderer.

Ejemplo de uso

    RectangleShape {
        id: rectangleShape
        anchors.centerIn: parent
        radius: 0
        topLeftRadius: 30
        bottomRightRadius: 30
        bevel: true
        joinStyle: ShapePath.MiterJoin
        fillColor: "#3ad23c"
        strokeColor: "transparent"
        visible: false
    }

Rectángulo verde con esquinas biseladas

Documentación de la propiedad

bevel : bool

Esta propiedad define si las esquinas del rectángulo están biseladas.

Si se establece en « false », las esquinas quedarán afiladas o redondeadas, dependiendo de los valores de las propiedades individuales « radius ».

Esta propiedad puede ser anulada por las propiedades de bisel individuales.

    RectangleShape {
        id: rectangleShape
        anchors.centerIn: parent
        radius: 0
        topLeftRadius: 30
        bottomRightRadius: 30
        bevel: true
        joinStyle: ShapePath.MiterJoin
        fillColor: "#3ad23c"
        strokeColor: "transparent"
        visible: false
    }

Rectángulo con las esquinas superior izquierda e inferior derecha biseladas

Véase también « topLeftBevel », « topRightBevel », « bottomLeftBevel » y « bottomRightBevel ».

borderMode : enumeration

La propiedad «borderMode» determina dónde se dibuja el borde a lo largo del perímetro del rectángulo.

ConstanteDescripción
RectangleShape.InsideEl borde se dibuja a lo largo del borde interior del elemento y no afecta a la anchura del mismo.

Este es el valor predeterminado.

ConstanteDescripción
RectangleShape.MiddleEl borde se dibuja sobre el borde del elemento y no afecta a su anchura.
RectangleShape.OutsideEl borde se dibuja a lo largo del borde exterior del elemento y aumenta su anchura en el valor de strokeWidth.

Véase también « strokeWidth ».

bottomLeftBevel : bool

bottomRightBevel : bool

topLeftBevel : bool

topRightBevel : bool

Si se configuran, estas propiedades definen los biseles de cada esquina. Si se establecen en « false », se obtienen esquinas afiladas o redondeadas, dependiendo de los valores de las propiedades individuales « radius ». Si se establecen en « true », se obtienen esquinas biseladas. Cuando no se configuran, se utiliza en su lugar el valor de « bevel ».

Estas propiedades están desactivadas por defecto. Asigna undefined a estas propiedades para devolverlas al estado desactivado.

En el siguiente ejemplo, bottomRightBevel se establece en true:

    RectangleShape {
        id: rectangleShape
        anchors.centerIn: parent
        topLeftRadius: 0
        bottomRightBevel: true
        joinStyle: ShapePath.MiterJoin
    }

Contorno rectangular con tres esquinas redondeadas y una esquina biselada

Véase también bevel.

bottomLeftRadius : real

bottomRightRadius : real

topLeftRadius : real

topRightRadius : real

Si se establecen, estas propiedades definen los radios de las esquinas de forma individual. Un valor cero indica que la esquina es aguda, mientras que un valor positivo indica que es redondeada. Cuando no se establecen, se utiliza en su lugar el valor de ` radius `.

Estas propiedades están desactivadas por defecto. Asigna undefined a ellas para devolverlas al estado desactivado.

En el siguiente ejemplo, radius se establece en 10 y topLeftRadius en 0:

    RectangleShape {
        id: rectangleShape
        anchors.centerIn: parent
        topLeftRadius: 0
        bottomRightBevel: true
        joinStyle: ShapePath.MiterJoin
    }

Contorno rectangular con tres esquinas redondeadas y una esquina biselada

Véase también « radius ».

capStyle : enumeration

Esta propiedad define cómo se dibujan los extremos de las líneas. El valor por defecto es « ShapePath.SquareCap ».

ConstanteDescripción
ShapePath.FlatCapUn extremo de línea cuadrado que no cubre el punto final de la línea.
ShapePath.SquareCapUn extremo de línea cuadrado que cubre el punto final y se extiende más allá de él la mitad del ancho de la línea.
ShapePath.RoundCapUn extremo de línea redondeado.

dashOffset : real

Esta propiedad define el punto inicial del patrón de guiones, medido en las unidades utilizadas para especificar dicho patrón.

El valor por defecto es 0.

Véase también QPen::setDashOffset().

dashPattern : list<real>

Esta propiedad define el patrón de guiones cuando strokeStyle se establece en ShapePath.DashLine. El patrón debe especificarse como un número par de entradas positivas, en las que las entradas 1, 3, 5... son los guiones y las 2, 4, 6... son los espacios. El patrón se especifica en unidades del ancho del trazo.

El valor por defecto es (4, 2), lo que significa un guion de 4 * strokeWidth píxeles seguido de un espacio de 2 * strokeWidth píxeles.

Véase también QPen::setDashPattern().

drawBottom : bool [since 6.11]

Esta propiedad determina si se dibuja el borde inferior.

El valor por defecto es « true ».

Esta propiedad se introdujo en Qt 6.11.

drawLeft : bool [since 6.11]

Esta propiedad determina si se dibuja el borde izquierdo.

El valor por defecto es « true ».

Esta propiedad se introdujo en Qt 6.11.

drawRight : bool [since 6.11]

Esta propiedad determina si se dibuja el borde derecho.

El valor por defecto es « true ».

Esta propiedad se introdujo en Qt 6.11.

drawTop : bool [since 6.11]

Esta propiedad determina si se dibuja el borde superior.

El valor por defecto es « true ».

Esta propiedad se introdujo en Qt 6.11.

fillColor : color

Esta propiedad define el color de relleno.

Si se establece en « transparent », no se aplica ningún relleno.

El valor predeterminado es « "white" ».

Nota: Si cualquiera de los valores « fillGradient » se establece en algo distinto de « null », se utilizará ese valor en lugar de « fillColor ».

fillGradient : ShapeGradient

El «fillGradient» del color de relleno del rectángulo.

Por defecto, no hay ningún «fillGradient» habilitado y el valor es nulo. En este caso, el relleno utiliza un color sólido basado en el valor de « fillColor ».

Cuando se establece, se ignora « fillColor » y el relleno se realiza utilizando uno de los subtipos de « ShapeGradient ».

Nota: El tipo « Gradient » no se puede utilizar aquí. Es preferible utilizar uno de los subtipos avanzados, como « LinearGradient ».

fillRule : enumeration

Esta propiedad define la regla de relleno. El valor por defecto es ShapePath.OddEvenFill. Para obtener una explicación sobre las reglas de relleno, consulta QPainterPath::setFillRule().

ConstanteDescripción
ShapePath.OddEvenFillRegla de relleno par-impar.
ShapePath.WindingFillRegla de relleno de bobinado distinta de cero.

joinStyle : enumeration

Esta propiedad define cómo se dibujan las uniones entre dos líneas conectadas. El valor por defecto es « ShapePath.BevelJoin ».

ConstanteDescripción
ShapePath.MiterJoinLos bordes exteriores de las líneas se extienden hasta encontrarse en ángulo, y esta zona se rellena.
ShapePath.BevelJoinSe rellena la muesca triangular entre las dos líneas.
ShapePath.RoundJoinSe rellena un arco circular entre las dos líneas.

radius : real

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

Si el radio es un valor positivo, el trazado del rectángulo se definirá como un rectángulo redondeado; en caso contrario, se definirá como un rectángulo normal.

Esta propiedad puede ser anulada por las propiedades individuales de radio de las esquinas.

El valor por defecto es 10.

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

strokeColor : color

Esta propiedad define el color del trazo.

Cuando se establece en « transparent », no se aplica ningún trazo.

El valor por defecto es « "black" ».

strokeStyle : enumeration

Esta propiedad define el estilo del trazo. El valor por defecto es ShapePath.SolidLine.

ConstanteDescripción
ShapePath.SolidLineUna línea continua.
ShapePath.DashLineTrazos separados por unos pocos píxeles.

strokeWidth : real

Esta propiedad determina el ancho del trazo.

Si se establece en un valor negativo, no se traza el trazo.

El valor por defecto es 1.

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