RectangleShape QML Type
Ein gefülltes Rechteck mit einem optionalen Rand. Mehr...
| Import Statement: | import QtQuick.Shapes.DesignHelpers 6.11 |
| Since: | QtQuick 6.10 |
Eigenschaften
- 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
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 QtQuick.Shapes::Shape::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
bevel : bool
Diese Eigenschaft legt fest, ob die Ecken des Rechtecks abgeschrägt sind.
Die Einstellung false ergibt 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 Rahmen entlang der Kante des Rechtecks gezeichnet wird.
| Konstante | Beschreibung |
|---|---|
RectangleShape.Inside | Der Rahmen wird entlang der Innenkante des Elements gezeichnet und hat keinen Einfluss auf die Elementbreite. |
Dies ist der Standardwert.
| Konstante | Beschreibung |
|---|---|
RectangleShape.Middle | Der Rahmen wird über den Rand des Artikels gezeichnet und hat keinen Einfluss auf die Artikelbreite. |
RectangleShape.Outside | Der Rahmen wird entlang der Außenkante des Eintrags gezeichnet und erhöht die Artikelbreite um den Wert von strokeWidth. |
Siehe auch strokeWidth.
Wenn diese Eigenschaften festgelegt sind, definieren sie die einzelnen Eckschrägen. Wenn sie auf false eingestellt sind, ergeben sich entweder scharfe oder abgerundete Ecken, je nach den Werten der einzelnen Eigenschaften von 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.
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.
capStyle : enumeration
Diese Eigenschaft legt fest, wie die Endpunkte von Linien gezeichnet werden. Der Standardwert ist ShapePath.SquareCap.
| Konstante | Beschreibung |
|---|---|
ShapePath.FlatCap | Ein quadratisches Linienende, das den Endpunkt der Linie nicht überdeckt. |
ShapePath.SquareCap | Ein quadratisches Linienende, das den Endpunkt überdeckt und um die Hälfte der Linienbreite darüber hinausgeht. |
ShapePath.RoundCap | Ein 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 Bindestrichmuster, 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 fillGradient auf einen anderen Wert als null eingestellt ist, wird dieser 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 Ausfüllregel. Der Standardwert ist ShapePath.OddEvenFill. Für eine Erklärung der Füllregeln siehe QPainterPath::setFillRule().
| Konstante | Beschreibung |
|---|---|
ShapePath.OddEvenFill | Ungerade-gerade Ausfüllregel. |
ShapePath.WindingFill | Nicht-Null-Wicklung Füllregel. |
joinStyle : enumeration
Diese Eigenschaft legt fest, wie Verbindungen zwischen zwei verbundenen Linien gezeichnet werden. Der Standardwert ist ShapePath.BevelJoin.
| Konstante | Beschreibung |
|---|---|
ShapePath.MiterJoin | Die Außenkanten der Linien werden so verlängert, dass sie sich in einem Winkel treffen, und dieser Bereich wird gefüllt. |
ShapePath.BevelJoin | Die dreieckige Kerbe zwischen den beiden Linien wird ausgefüllt. |
ShapePath.RoundJoin | Ein Kreisbogen zwischen den beiden Linien wird ausgefüllt. |
radius : real
Diese Eigenschaft legt den Eckenradius fest, 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 bestimmt die Farbe des Strichs.
Wenn sie auf transparent eingestellt ist, erfolgt keine Konturierung.
Der Standardwert ist "black".
strokeStyle : enumeration
Diese Eigenschaft definiert den Stil der Striche. Der Standardwert ist ShapePath.SolidLine.
| Konstante | Beschreibung |
|---|---|
ShapePath.SolidLine | Eine einfache Linie. |
ShapePath.DashLine | Striche, die durch ein paar Pixel getrennt sind. |
strokeWidth : real
Diese Eigenschaft bestimmt die Strichstärke.
Wenn sie auf einen negativen Wert eingestellt ist, wird kein Strich ausgeführt.
Der Standardwert ist 1.
© 2026 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.