RegularPolygonShape QML Type
Ein gefülltes regelmäßiges Polygon mit einem optionalen Rand. Mehr...
| Import Statement: | import QtQuick.Shapes.DesignHelpers 6.11 |
| Since: | QtQuick 6.10 |
Eigenschaften
- capStyle : enumeration
- cornerRadius : real
- dashOffset : real
- dashPattern : list<real>
- fillColor : color
- fillGradient : ShapeGradient
- joinStyle : enumeration
- sideCount : int
- strokeColor : color
- strokeStyle : enumeration
- strokeWidth : real
Detaillierte Beschreibung
Ein regelmäßiges Polygon kann nur ein 2D polygonförmiger Strich, eine Füllung oder ein Strich mit Füllung sein. Die Eigenschaften strokeColor, strokeWidth und strokeStyle bestimmen das Aussehen des Umrisses. Die Eigenschaften dashPattern und dashOffset legen das Aussehen der gestrichelten Kontur fest.
Der Bereich innerhalb der Kontur wird entweder mit einer Volltonfarbe, die mit der Eigenschaft fillColor angegeben wird, oder mit einem Farbverlauf gezeichnet, der mit einem der ShapeGradient Untertypen definiert und mit der Eigenschaft gradient eingestellt wird. Wenn sowohl eine Farbe als auch ein Farbverlauf angegeben sind, wird der Farbverlauf verwendet.
Um ein Polygon mit einem Strich zu erstellen, setzen Sie die Eigenschaft sideCount auf einen Wert zwischen 3 und 100 und die Eigenschaft strokeWidth auf einen Wert größer als 0. Die Eigenschaft strokeWidth gibt die Breite des Polygonstrichs an. Der Standardwert sideCount ist 6 und der Standardwert strokeWidth ist 4. Wenn Sie den Wert strokeWidth auf einen negativen Wert setzen, wird der Rand ausgeblendet.
Die Eigenschaft cornerRadius legt fest, ob die Ecken des Polygons abgerundet werden.
Dokumentation der Eigenschaft
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. |
Da ein Polygon gezeichnet wird, bildet der Pfad eine Schleife ohne Linienendpunkte. Daher wird capStyle nur benötigt, wenn strokeStyle == ShapePath.DashLine
cornerRadius : real
Die Eigenschaft gibt an, ob die Ecken des Polygons abgerundet werden.
Der Standardwert ist 10.
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 Polygonfüllfarbe.
Standardmäßig ist kein fillGradient aktiviert und der Wert ist null. In diesem Fall verwendet die Füllung eine Volltonfarbe, 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.
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. |
Der joinStyle ist nur sinnvoll, wenn cornerRadius == 0.
sideCount : int
Die Anzahl der Kanten des regelmäßigen Polygons. Die Mindestanzahl der Kanten kann 3 betragen.
Der Standardwert ist 6.
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.
