PathRectangle QML Type

Définit un rectangle dont les coins peuvent être arrondis. En savoir plus…

• 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 permet de définir facilement un rectangle, avec, au choix, 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 relative aux propriétés

bevel : bool [since 6.10]

Cette propriété permet de déterminer si les coins du rectangle sont biseautés.

Si vous la définissez sur « false », les coins seront soit nets, soit arrondis, selon les valeurs attribuées aux différentes propriétés « radius ».

Cette propriété peut être remplacée par les propriétés de biseautage 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 également topLeftBevel, topRightBevel, bottomLeftBevel et bottomRightBevel.

Si elles sont définies, ces propriétés déterminent le biseautage de chaque coin. En leur attribuant la valeur « false », on obtient soit des coins vifs, soit des coins arrondis, selon les valeurs attribuées à chacune des propriétés « radius ». En leur attribuant la valeur « true », on obtient des coins biseautés. Lorsqu’elles ne sont pas définies, c’est la valeur de « bevel » qui 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 désactivé.

Dans l’exemple suivant, bottomRightBevel est défini sur 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 également « bevel ».

Si elles sont définies, ces propriétés déterminent les rayons de chaque coin. Une valeur nulle indique que le coin est pointu, tandis qu’une valeur positive indique qu’il est arrondi. Si elles ne sont pas définies, c’est la valeur de « radius » qui est utilisée à la place.

Ces propriétés sont désactivées par défaut. Attribuez-leur la valeur « undefined » pour les ramener à leur état initial.

Dans l'exemple suivant, radius est défini sur 10 et topLeftRadius sur 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 également radius.

Définit la largeur et la hauteur du rectangle.

Voir également x et y.

radius : real

Cette propriété définit le rayon des coins utilisé pour définir un rectangle arrondi.

Si la valeur de radius est positive, le tracé du rectangle sera défini comme un rectangle arrondi ; dans le cas contraire, il sera défini comme un rectangle normal.

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

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 tracé.

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

Il est possible de combiner des positions relatives et absolues ; par exemple, il est valable de définir une position x relative et une position y absolue.

Voir également x et y.

strokeAdjustment : real

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

Lorsqu’elle est utilisée dans un élément « ShapePath » avec le tracé activé, le rectangle tracé s’étendra par défaut au-delà du rectangle défini de la moitié de la largeur du trait sur tous les côtés. Il s’agit du comportement attendu, puisque le chemin définit la ligne médiane du tracé et correspond au rendu « QPainter » et au rendu SVG.

Si l’on souhaite au contraire que le rectangle défini constitue le bord extérieur du rectangle tracé, à l’instar d’un élément d’ Rectangle avec une bordure, on peut définir `strokeAdjustment` sur la largeur du trait. Cela décalera effectivement 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'agira également du point de départ et du point d'arrivée du tracé.

Voir également relativeX et relativeY.