PathRectangle QML Type

Définit un rectangle dont les coins peuvent être arrondis. Plus d'informations...

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

Propriétés

• bevel : bool (since 6.10)
• bottomLeftBevel : bool
• bottomLeftRadius : real
• bottomRightBevel : bool
• bottomRightRadius : real
• height : real
• radius : real
• relativeX : real
• relativeY : real
• strokeAdjustment : real
• topLeftBevel : bool
• topLeftRadius : real
• topRightBevel : bool
• topRightRadius : real
• width : real
• x : real
• y : real

Description détaillée

PathRectangle est un moyen simple de spécifier un rectangle, avec éventuellement des coins arrondis ou biseautés. L'API correspond à celle de l'élément Rectangle.

    Shape {
        id: rectangleShape
        width: 200
        height: 150
        anchors.centerIn: parent
        preferredRendererType: Shape.CurveRenderer

        ShapePath {
            fillColor: "#3ad23c"

            PathRectangle {
                width: rectangleShape.width
                height: rectangleShape.height
                topLeftRadius: 30
                bottomRightRadius: 30
                bevel: true
            }
        }
    }

Voir également Path, PathLine, PathQuad, PathCubic, PathArc, PathAngleArc, PathCurve, et PathSvg.

Documentation sur les propriétés

bevel : bool [since 6.10]

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.

    Shape {
        id: rectangleShape
        width: 200
        height: 150
        anchors.centerIn: parent
        preferredRendererType: Shape.CurveRenderer

        ShapePath {
            fillColor: "#3ad23c"

            PathRectangle {
                width: rectangleShape.width
                height: rectangleShape.height
                topLeftRadius: 30
                bottomRightRadius: 30
                bevel: true
            }
        }
    }

Cette propriété a été introduite dans Qt 6.10.

Voir aussi topLeftBevel, topRightBevel, bottomLeftBevel, et bottomRightBevel.

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 :

    Shape {
        id: rectangleShape
        width: 200
        height: 150
        anchors.centerIn: parent
        preferredRendererType: Shape.CurveRenderer

        ShapePath {
            strokeColor: "black"
            strokeWidth: 4
            joinStyle: ShapePath.MiterJoin

            PathRectangle {
                width: rectangleShape.width
                height: rectangleShape.height
                radius: 10
                topLeftRadius: 0
                bottomRightBevel: true
            }
        }
    }

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:

    Shape {
        id: rectangleShape
        width: 200
        height: 150
        anchors.centerIn: parent
        preferredRendererType: Shape.CurveRenderer

        ShapePath {
            strokeColor: "black"
            strokeWidth: 4
            joinStyle: ShapePath.MiterJoin

            PathRectangle {
                width: rectangleShape.width
                height: rectangleShape.height
                radius: 10
                topLeftRadius: 0
                bottomRightBevel: true
            }
        }
    }

Voir aussi radius.

Définit la largeur et la hauteur du rectangle.

Voir également x et y.

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

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

Définit le coin supérieur gauche du rectangle par rapport au point de départ du chemin.

Si une position finale relative et une position finale absolue sont spécifiées pour un même axe, c'est la position relative qui sera utilisée.

Les positions relatives et absolues peuvent être mélangées ; par exemple, il est possible de définir une position relative x et une position absolue y.

Voir également x et y.

strokeAdjustment : real

Cette propriété définit l'ajustement de la largeur du trait aux coordonnées du rectangle.

Lorsqu'il est utilisé dans un site ShapePath et que le tracé est activé, le rectangle tracé dépassera par défaut le rectangle défini de la moitié de la largeur du tracé sur tous les côtés. C'est le comportement attendu puisque le chemin définit la ligne médiane du tracé et correspond à QPainter et au rendu SVG.

Si l'on souhaite que le rectangle défini soit le bord extérieur du rectangle tracé, comme dans le cas d'un élément Rectangle avec une bordure, on peut définir strokeAdjustment sur la largeur du trait. Cela aura pour effet de décaler tous les bords vers l'intérieur de la moitié de la largeur du trait. Comme dans l'exemple suivant :

ShapePath {
    id: myRec
    fillColor: "white"
    strokeColor: "black"
    strokeWidth: 16
    joinStyle: ShapePath.MiterJoin

    PathRectangle { x: 10; y: 10; width: 200; height: 100; strokeAdjustment: myRec.strokeWidth }
}

Définit le coin supérieur gauche du rectangle.

À moins que ce coin ne soit arrondi, il s'agit également du point de départ et d'arrivée du chemin.

Voir également relativeX et relativeY.