RectangleShape QML Type

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

• Lista de todos los miembros, incluidos los heredados

Propiedades

• bevel : bool
• borderMode : enumeration
• bottomLeftBevel : bool
• bottomLeftRadius : real
• bottomRightBevel : bool
• bottomRightRadius : real
• capStyle : enumeration
• dashOffset : real
• dashPattern : list<real>
• 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 colores sólidos o degradados y para proporcionar 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 especifica 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 estableciendo las propiedades strokeColor y strokeWidth. Si se establece el color en transparent, se crea un borde sin color de relleno.

Los rectángulos redondeados pueden dibujarse utilizando la propiedad radius. El radio también puede especificarse por separado para cada esquina. Además, bevel puede aplicarse a cualquier esquina para cortarla bruscamente.

El valor por defecto 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 se obtienen esquinas afiladas o redondeadas, dependiendo de los valores de las propiedades individuales de 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 borde del rectángulo.

Este es el valor por defecto.

Véase también strokeWidth.

Si se establecen, estas propiedades definen los biseles individuales de las esquinas. Si se establecen en false, se obtienen esquinas afiladas o redondeadas, dependiendo de los valores de las propiedades individuales de radius. Si se establecen en true, se obtienen esquinas biseladas. Si no se establecen, se utiliza el valor de bevel.

Estas propiedades están desactivadas por defecto. Asígneles undefined para que vuelvan a su estado original.

En el siguiente ejemplo, bottomRightBevel tiene el valor verdadero:

    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 individuales de las esquinas. Un valor cero define que esa esquina sea afilada, mientras que un valor positivo define que sea redondeada. Si no se definen, se utiliza el valor de radius.

Estas propiedades están desactivadas por defecto. Asigne undefined a estas propiedades para que vuelvan a estar desactivadas.

En el siguiente ejemplo, radius se asigna a 10, y topLeftRadius a 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 puntos finales de las líneas. El valor por defecto es ShapePath.SquareCap.

dashOffset : real

Esta propiedad define el punto de inicio en el patrón de guiones, medido en unidades utilizadas para especificar el patrón de guiones.

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 donde las entradas 1, 3, 5... son los guiones y 2, 4, 6... son los espacios. El patrón se especifica en unidades del ancho de la pluma.

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

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

fillColor : color

Esta propiedad contiene el color de relleno.

Cuando se establece en transparent, no se produce relleno.

El valor por defecto es "white".

fillGradient : ShapeGradient

El fillGradient del color de relleno del rectángulo.

Por defecto, no se activa fillGradient y el valor es null. En este caso, el relleno utiliza un color sólido basado en el valor de fillColor.

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

fillRule : enumeration

Esta propiedad contiene la regla de relleno. El valor por defecto es ShapePath.OddEvenFill. Para una explicación de las reglas de relleno, véase QPainterPath::setFillRule().

joinStyle : enumeration

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

radius : real

Esta propiedad define el radio de la esquina utilizado 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 contiene el color del trazo.

Cuando se establece en transparent, no se produce el trazo.

El valor por defecto es "black".

strokeStyle : enumeration

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

strokeWidth : real

Esta propiedad contiene el ancho del trazo.

Cuando se establece en un valor negativo, no se produce el trazo.

El valor por defecto es 1.