PathRectangle QML Type

Definiert ein Rechteck mit optional abgerundeten Ecken. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• 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

Ausführliche Beschreibung

PathRectangle bietet eine einfache Möglichkeit, ein Rechteck festzulegen, optional mit abgerundeten oder abgeschrägten Ecken. Die API entspricht der des Elements „ 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
            }
        }
    }

Siehe auch „ Path“ , „ PathLine “, „ PathQuad “, „ PathCubic “, „ PathArc “, „ PathAngleArc “, „ PathCurve “ und „ PathSvg “.

Dokumentation zu Eigenschaften

bevel : bool [since 6.10]

Diese Eigenschaft legt fest, ob die Ecken des Rechtecks abgeschrägt sind.

Wird der Wert auf „ false “ gesetzt, führt dies je nach den Werten der einzelnen „ radius “-Eigenschaften entweder zu scharfen oder zu abgerundeten Ecken.

Diese Eigenschaft kann durch die einzelnen „bevel“-Eigenschaften überschrieben werden.

    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
            }
        }
    }

Diese Eigenschaft wurde in Qt 6.10 eingeführt.

Siehe auch „ topLeftBevel“ , „ topRightBevel “, „ bottomLeftBevel “ und „ bottomRightBevel “.

Wenn diese Eigenschaften gesetzt sind, definieren sie die einzelnen Eckenabschrägungen. Werden sie auf „ false “ gesetzt, führt dies je nach den Werten der einzelnen Eigenschaften „ radius “ zu scharfen oder abgerundeten Ecken. Werden sie auf „ true “ gesetzt, führt dies zu abgeschrägten Ecken. Sind sie nicht gesetzt, wird stattdessen der Wert von „ bevel “ verwendet.

Diese Eigenschaften sind standardmäßig nicht gesetzt. Weisen Sie ihnen „ undefined “ zu, um sie wieder in den nicht gesetzten Zustand zu versetzen.

Im folgenden Beispiel ist „ bottomRightBevel “ auf „true“ gesetzt:

    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
            }
        }
    }

Siehe auch „ bevel “.

Wenn diese Eigenschaften festgelegt sind, definieren sie die einzelnen Eckenradien. Ein Wert von Null bedeutet, dass die Ecke scharf ist, während ein positiver Wert eine abgerundete Ecke definiert. Sind sie nicht festgelegt, wird stattdessen der Wert von „ radius “ verwendet.

Diese Eigenschaften sind standardmäßig nicht gesetzt. Weisen Sie ihnen „ undefined “ zu, um sie wieder in den nicht gesetzten Zustand zu versetzen.

Im folgenden Beispiel ist ` radius ` auf ` 10` und ` topLeftRadius ` auf ` 0` gesetzt:

    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
            }
        }
    }

Siehe auch „ radius “.

Legt die Breite und Höhe des Rechtecks fest.

Siehe auch x und y.

radius : real

Diese Eigenschaft legt den Eckenradius fest, der zur Definition eines abgerundeten Rechtecks verwendet wird.

Ist „radius“ ein positiver Wert, wird der Rechteckpfad als abgerundetes Rechteck definiert, andernfalls als normales Rechteck.

Diese Eigenschaft kann durch die einzelnen Eigenschaften für den Eckenradius überschrieben werden.

Der Standardwert ist „ 0 “.

Siehe auch „ topLeftRadius“ , „ topRightRadius “, „ bottomLeftRadius “ und „ bottomRightRadius “.

Definiert die obere linke Ecke des Rechtecks relativ zum Startpunkt des Pfades.

Wenn für eine einzelne Achse sowohl eine relative als auch eine absolute Endposition angegeben wird, wird die relative Position verwendet.

Relative und absolute Positionen können gemischt werden; so ist es beispielsweise zulässig, eine relative x- und eine absolute y-Position festzulegen.

Siehe auch x und y.

strokeAdjustment : real

Diese Eigenschaft legt die Anpassung der Strichbreite an die Koordinaten des Rechtecks fest.

Bei Verwendung in einem „ ShapePath “ mit aktivierter Konturierung erstreckt sich das tatsächlich konturierte Rechteck standardmäßig auf allen Seiten um die Hälfte der Strichbreite über das definierte Rechteck hinaus. Dies ist das erwartete Verhalten, da der Pfad die Mittellinie der Konturierung definiert und der Darstellung in „ QPainter “ sowie der SVG-Rendering-Regel entspricht.

Wenn man stattdessen möchte, dass das definierte Rechteck die Außenkante des umrandeten Rechtecks bildet – ähnlich wie bei einem „ Rectangle “-Element mit Rahmen –, kann man „strokeAdjustment“ auf die Strichbreite setzen. Dadurch werden alle Kanten effektiv um die Hälfte der Strichbreite nach innen verschoben. Wie im folgenden Beispiel:

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

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

Definiert die obere linke Ecke des Rechtecks.

Sofern diese Ecke nicht abgerundet ist, ist dies auch der Start- und Endpunkt des Pfades.

Siehe auch relativeX und relativeY.