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
- bevel : bool
- borderMode : enumeration
- bottomLeftBevel : bool
- bottomLeftRadius : real
- bottomRightBevel : bool
- bottomRightRadius : real
- capStyle : enumeration
- dashOffset : real
- dashPattern : list<real>
- drawBottom : bool
(since 6.11) - drawLeft : bool
(since 6.11) - drawRight : bool
(since 6.11) - drawTop : bool
(since 6.11) - fillColor : color
- fillGradient : ShapeGradient
- fillRule : enumeration
- joinStyle : enumeration
- radius : real
- strokeColor : color
- strokeStyle : enumeration
- strokeWidth : real
- topLeftBevel : bool
- topLeftRadius : real
- topRightBevel : bool
- topRightRadius : real
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
}
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
}
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.
| Constante | Descripción |
|---|---|
RectangleShape.Inside | El borde se dibuja a lo largo del borde interior del elemento y no afecta a la anchura del mismo. |
Este es el valor predeterminado.
| Constante | Descripción |
|---|---|
RectangleShape.Middle | El borde se dibuja sobre el borde del elemento y no afecta a su anchura. |
RectangleShape.Outside | El 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 ».
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
}
Véase también bevel.
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
}
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 ».
| Constante | Descripción |
|---|---|
ShapePath.FlatCap | Un extremo de línea cuadrado que no cubre el punto final de la línea. |
ShapePath.SquareCap | Un 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.RoundCap | Un 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().
| Constante | Descripción |
|---|---|
ShapePath.OddEvenFill | Regla de relleno par-impar. |
ShapePath.WindingFill | Regla 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 ».
| Constante | Descripción |
|---|---|
ShapePath.MiterJoin | Los bordes exteriores de las líneas se extienden hasta encontrarse en ángulo, y esta zona se rellena. |
ShapePath.BevelJoin | Se rellena la muesca triangular entre las dos líneas. |
ShapePath.RoundJoin | Se 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.
| Constante | Descripción |
|---|---|
ShapePath.SolidLine | Una línea continua. |
ShapePath.DashLine | Trazos 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.