RectangleShape QML Type

Un rectangle rempli avec une bordure optionnelle. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• 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

Description détaillée

RectangleShape est utilisé pour remplir des zones avec une couleur unie ou des dégradés et pour fournir une bordure rectangulaire.

Chaque élément Rectangle est peint à l'aide d'une couleur de remplissage unie, spécifiée à l'aide de la propriété fillColor, ou d'un dégradé, défini à l'aide de l'un des sous-types ShapeGradient et défini à l'aide de la propriété gradient. Si une couleur et un dégradé sont spécifiés, c'est le dégradé qui est utilisé.

Une bordure optionnelle peut être ajoutée à un rectangle avec sa propre couleur et son épaisseur en définissant les propriétés strokeColor et strokeWidth. La définition de la couleur à transparent crée une bordure sans couleur de remplissage.

Les rectangles arrondis peuvent être dessinés à l'aide de la propriété radius. Le rayon peut également être spécifié séparément pour chaque coin. En outre, bevel peut être appliqué à n'importe quel coin pour le couper net.

La valeur par défaut de RectangleShape pour QtQuick.Shapes::Shape::preferredRendererType est Shape.CurveRenderer.

Exemple d'utilisation

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

Documentation sur les propriétés

bevel : bool

Cette propriété définit si les coins du rectangle sont biseautés.

En lui attribuant la valeur false, vous obtiendrez des angles vifs ou arrondis, en fonction des valeurs des propriétés radius.

Cette propriété peut être remplacée par les propriétés de biseau individuelles.

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

Voir également topLeftBevel, topRightBevel, bottomLeftBevel, et bottomRightBevel.

borderMode : enumeration

La propriété borderMode détermine où la bordure est dessinée le long du bord du rectangle.

Il s'agit de la valeur par défaut.

Voir également strokeWidth.

Si elles sont activées, ces propriétés définissent les biseaux des coins individuels. En leur attribuant la valeur false, on obtient des angles vifs ou arrondis, en fonction des valeurs des propriétés radius. En leur attribuant la valeur true, on obtient des coins biseautés. Si elles ne sont pas définies, la valeur de bevel est utilisée à la place.

Ces propriétés sont désactivées par défaut. Attribuez-leur la valeur undefined pour les ramener à l'état non défini.

Dans l'exemple suivant, la valeur de bottomRightBevel est fixée à true :

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

Voir aussi bevel.

Si elles sont activées, ces propriétés définissent les rayons de chaque coin. Une valeur nulle définit le coin comme étant pointu, tandis qu'une valeur positive le définit comme étant arrondi. Si cette propriété n'est pas définie, la valeur de radius est utilisée à la place.

Ces propriétés sont désactivées par défaut. Attribuez-leur undefined pour les ramener à l'état non défini.

Dans l'exemple suivant, radius est défini comme 10, et topLeftRadius comme 0:

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

Voir aussi radius.

capStyle : enumeration

Cette propriété définit la manière dont les extrémités des lignes sont dessinées. La valeur par défaut est ShapePath.SquareCap.

dashOffset : real

Cette propriété définit le point de départ du motif du tiret, mesuré dans les unités utilisées pour spécifier le motif du tiret.

La valeur par défaut est 0.

Voir également QPen::setDashOffset().

dashPattern : list<real>

Cette propriété définit le motif des tirets lorsque strokeStyle est défini sur ShapePath.DashLine. Le motif doit être spécifié sous la forme d'un nombre pair d'entrées positives où les entrées 1, 3, 5... sont les tirets et 2, 4, 6... sont les espaces. Le motif est spécifié en unités de largeur du stylo.

La valeur par défaut est (4, 2), ce qui signifie un tiret de 4 * strokeWidth pixels suivi d'un espace de 2 * strokeWidth pixels.

Voir également QPen::setDashPattern().

fillColor : color

Cette propriété définit la couleur de remplissage.

Si la valeur est transparent, il n'y a pas de remplissage.

La valeur par défaut est "white".

fillGradient : ShapeGradient

Le gradient de remplissage de la couleur de remplissage du rectangle.

Par défaut, aucun fillGradient n'est activé et la valeur est nulle. Dans ce cas, le remplissage utilise une couleur unie basée sur la valeur de fillColor.

Lorsqu'il est défini, fillColor est ignoré et le remplissage est effectué à l'aide de l'un des sous-types ShapeGradient.

fillRule : enumeration

Cette propriété contient la règle de remplissage. La valeur par défaut est ShapePath.OddEvenFill. Pour une explication sur les règles de remplissage, voir QPainterPath::setFillRule().

joinStyle : enumeration

Cette propriété définit la manière dont sont dessinées les jointures entre deux lignes connectées. La valeur par défaut est ShapePath.BevelJoin.

radius : real

Cette propriété définit le rayon de l'angle utilisé pour définir un rectangle arrondi.

Si le rayon est une valeur positive, le tracé du rectangle sera défini comme un rectangle arrondi, sinon il sera défini comme un rectangle normal.

Cette propriété peut être remplacée par les propriétés individuelles de rayon d'angle.

La valeur par défaut est 10.

Voir également topLeftRadius, topRightRadius, bottomLeftRadius, et bottomRightRadius.

strokeColor : color

Cette propriété définit la couleur de l'effet de caresse.

Lorsqu'elle est définie sur transparent, il n'y a pas de tracé.

La valeur par défaut est "black".

strokeStyle : enumeration

Cette propriété définit le style de trait. La valeur par défaut est ShapePath.SolidLine.

strokeWidth : real

Cette propriété définit la largeur du trait.

Lorsqu'elle est définie sur une valeur négative, aucun trait n'est effectué.

La valeur par défaut est 1.