RectangleShape QML Type

Ein gefülltes Rechteck mit einem optionalen Rand. Mehr...

Import Statement: import QtQuick.Shapes.DesignHelpers 6.10
Since: QtQuick 6.10

Eigenschaften

Detaillierte Beschreibung

RectangleShape wird verwendet, um Bereiche mit einer Volltonfarbe oder einem Farbverlauf zu füllen und einen rechteckigen Rahmen zu erstellen.

Jedes Rectangle-Element wird entweder mit einer Volltonfarbe gefüllt, die über die Eigenschaft fillColor angegeben wird, oder mit einem Farbverlauf, der über einen der ShapeGradient -Subtypen definiert und über die Eigenschaft gradient festgelegt wird. Wenn sowohl eine Farbe als auch ein Farbverlauf angegeben sind, wird der Farbverlauf verwendet.

Einem Rechteck kann ein optionaler Rahmen mit eigener Farbe und Dicke hinzugefügt werden, indem die Eigenschaften strokeColor und strokeWidth eingestellt werden. Die Einstellung der Farbe auf transparent erzeugt einen Rahmen ohne Füllfarbe.

Abgerundete Rechtecke können mit der Eigenschaft radius gezeichnet werden. Der Radius kann auch für jede Ecke separat festgelegt werden. Außerdem kann bevel auf jede Ecke angewendet werden, um sie scharf abzuschneiden.

Der Standardwert von RectangleShape für preferredRendererType ist Shape.CurveRenderer.

Beispiel für die Verwendung

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

Dokumentation der Eigenschaft

bottomLeftRadius : real

bottomRightRadius : real

topLeftRadius : real

topRightRadius : real

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 bedeutet, dass sie abgerundet ist. Wenn sie nicht gesetzt sind, wird stattdessen der Wert von radius verwendet.

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

Im folgenden Beispiel wird radius auf 10 und topLeftRadius auf 0 gesetzt:

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

Siehe auch radius.


bottomLeftBevel : bool

bottomRightBevel : bool

topLeftBevel : bool

topRightBevel : bool

Wenn diese Eigenschaften festgelegt sind, definieren sie die einzelnen Eckschrägen. Die Einstellung false ergibt entweder scharfe oder abgerundete Ecken, abhängig von den Werten der einzelnen Eigenschaften radius. Wenn sie auf true gesetzt sind, ergeben sich abgeschrägte Ecken. Wenn sie nicht gesetzt sind, wird stattdessen der Wert von bevel verwendet.

Diese Eigenschaften sind standardmäßig nicht eingestellt. Weisen Sie ihnen undefined zu, um sie in den ungesetzten Zustand zu versetzen.

Im folgenden Beispiel ist bottomRightBevel auf true gesetzt:

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

Siehe auch bevel.


bevel : bool

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

Wenn sie auf false gesetzt wird, ergeben sich entweder scharfe oder abgerundete Ecken, abhängig von den Werten der einzelnen radius Eigenschaften.

Diese Eigenschaft kann durch die einzelnen Fasen-Eigenschaften außer Kraft gesetzt werden.

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

Siehe auch topLeftBevel, topRightBevel, bottomLeftBevel, und bottomRightBevel.


borderMode : enumeration

Die Eigenschaft borderMode bestimmt, wo der Rand entlang der Kante des Rechtecks gezeichnet wird.

KonstanteBeschreibung
RectangleShape.InsideDer Rahmen wird entlang der Innenkante des Elements gezeichnet und hat keinen Einfluss auf die Elementbreite.

Dies ist der Standardwert.

KonstanteBeschreibung
RectangleShape.MiddleDer Rahmen wird über den Rand des Artikels gezeichnet und hat keinen Einfluss auf die Artikelbreite.
RectangleShape.OutsideDer Rahmen wird entlang der Außenkante des Eintrags gezeichnet und erhöht die Artikelbreite um den Wert von strokeWidth.

Siehe auch strokeWidth.


capStyle : enumeration

Diese Eigenschaft legt fest, wie die Endpunkte von Linien gezeichnet werden. Der Standardwert ist ShapePath.SquareCap.

KonstanteBeschreibung
ShapePath.FlatCapEin quadratisches Linienende, das den Endpunkt der Linie nicht überdeckt.
ShapePath.SquareCapEin quadratisches Linienende, das den Endpunkt überdeckt und um die Hälfte der Linienbreite darüber hinausgeht.
ShapePath.RoundCapEin abgerundetes Linienende.

dashOffset : real

Diese Eigenschaft definiert den Startpunkt des Strichmusters, gemessen in den Einheiten, die zur Festlegung des Strichmusters verwendet werden.

Der Standardwert ist 0.

Siehe auch QPen::setDashOffset().


dashPattern : list<real>

Diese Eigenschaft definiert das Strichelmuster, wenn strokeStyle auf ShapePath.DashLine gesetzt ist. Das Muster muss als gerade Anzahl von positiven Einträgen angegeben werden, wobei die Einträge 1, 3, 5... die Striche und 2, 4, 6... die Leerzeichen sind. Das Muster wird in Einheiten der Stiftbreite angegeben.

Der Standardwert ist (4, 2), d. h. ein Gedankenstrich von 4 * strokeWidth Pixeln gefolgt von einem Leerzeichen von 2 * strokeWidth Pixeln.

Siehe auch QPen::setDashPattern().


fillColor : color

Diese Eigenschaft enthält die Füllfarbe.

Wenn sie auf transparent gesetzt ist, erfolgt keine Füllung.

Der Standardwert ist "white".

Hinweis: Wenn einer der beiden Werte fillGradient auf einen anderen Wert als null gesetzt ist, wird er anstelle von fillColor verwendet.


fillGradient : ShapeGradient

Der fillGradient der Füllfarbe des Rechtecks.

Standardmäßig ist kein fillGradient aktiviert und der Wert ist null. In diesem Fall wird für die Füllung eine Volltonfarbe verwendet, die auf dem Wert von fillColor basiert.

Wenn dieser Wert gesetzt ist, wird fillColor ignoriert und die Füllung erfolgt mit einem der ShapeGradient Untertypen.

Hinweis: Der Typ Gradient kann hier nicht verwendet werden. Verwenden Sie stattdessen lieber einen der erweiterten Subtypen wie LinearGradient.


fillRule : enumeration

Diese Eigenschaft enthält die Füllregel. Der Standardwert ist ShapePath.OddEvenFill. Eine Erklärung der Füllregeln finden Sie unter QPainterPath::setFillRule().

KonstanteBeschreibung
ShapePath.OddEvenFillUngerade-gerade Ausfüllregel.
ShapePath.WindingFillNicht-null-gewickelte Füllregel.

joinStyle : enumeration

Diese Eigenschaft definiert, wie Verbindungen zwischen zwei verbundenen Linien gezeichnet werden. Der Standardwert ist ShapePath.BevelJoin.

KonstanteBeschreibung
ShapePath.MiterJoinDie Außenkanten der Linien werden so verlängert, dass sie sich in einem Winkel treffen, und dieser Bereich wird gefüllt.
ShapePath.BevelJoinDie dreieckige Kerbe zwischen den beiden Linien wird ausgefüllt.
ShapePath.RoundJoinEin Kreisbogen zwischen den beiden Linien wird ausgefüllt.

radius : real

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

Wenn der Radius ein positiver Wert ist, wird der Rechteckpfad als abgerundetes Rechteck definiert, andernfalls als normales Rechteck.

Diese Eigenschaft kann durch die einzelnen Eckradius-Eigenschaften außer Kraft gesetzt werden.

Der Standardwert ist 10.

Siehe auch topLeftRadius, topRightRadius, bottomLeftRadius, und bottomRightRadius.


strokeColor : color

Diese Eigenschaft enthält die Farbe der Konturen.

Wenn sie auf transparent gesetzt ist, erfolgt keine Umrandung.

Der Standardwert ist "black".


strokeStyle : enumeration

Diese Eigenschaft legt den Stil der Konturen fest. Der Standardwert ist ShapePath. SolidLine.

KonstanteBeschreibung
ShapePath.SolidLineEine einfache Linie.
ShapePath.DashLineStriche, die durch ein paar Pixel getrennt sind.

strokeWidth : real

Diese Eigenschaft gibt die Strichstärke an.

Wenn sie auf einen negativen Wert gesetzt wird, erfolgt keine Strichelung.

Der Standardwert ist 1.


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.