RegularPolygonShape QML Type
Ein ausgefülltes regelmäßiges Vieleck mit optionalem Rand. Mehr...
| Import Statement: | import QtQuick.Shapes.DesignHelpers 6.12 |
| 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
Ausführliche Beschreibung
Ein regelmäßiges Polygon kann lediglich ein 2D-Polygon in Form einer Kontur, einer Füllung oder einer Kontur mit Füllung sein. Die Eigenschaften „ strokeColor “, „ strokeWidth “ und „ strokeStyle “ legen das Erscheinungsbild der Kontur fest. Die Eigenschaften „ dashPattern “ und „ dashOffset “ legen das Erscheinungsbild einer gestrichelten Kontur fest.
Der Bereich innerhalb der Kontur wird entweder mit einer durchgehenden Füllfarbe, die über die Eigenschaft „ fillColor “ festgelegt wird, oder mit einem Farbverlauf ausgefüllt, der mithilfe eines der Untertypen von „ ShapeGradient “ definiert und über die Eigenschaft „gradient“ festgelegt wird. Wenn sowohl eine Farbe als auch ein Farbverlauf angegeben sind, wird der Farbverlauf verwendet.
Um ein Polygon mit einer Kontur 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 “ legt die Breite der Polygonkontur fest. Der Standardwert für „ sideCount “ ist 6 und der Standardwert für „ strokeWidth “ ist 4. Wenn Sie den Wert von „ strokeWidth “ auf einen negativen Wert setzen, wird die Kontur ausgeblendet.
Die Eigenschaft „ cornerRadius “ legt fest, ob die Ecken des Polygons abgerundet sind.
Dokumentation zu den Eigenschaften
capStyle : enumeration
Diese Eigenschaft legt fest, wie die Endpunkte von Linien gezeichnet werden. Der Standardwert lautet „ ShapePath.SquareCap “.
| Konstante | Beschreibung |
|---|---|
ShapePath.FlatCap | Ein quadratisches Linienende, das den Endpunkt der Linie nicht überdeckt. |
ShapePath.SquareCap | Ein eckiges Linienende, das den Endpunkt überdeckt und um die Hälfte der Linienbreite darüber hinausragt. |
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 „property“ legt fest, ob die Ecken des Polygons abgerundet sind.
Der Standardwert lautet „ 10 “.
dashOffset : real
Diese Eigenschaft definiert den Startpunkt des Strichmusters, gemessen in den Einheiten, die zur Festlegung des Strichmusters verwendet werden.
Der Standardwert lautet „ 0 “.
Siehe auch ` QPen::setDashOffset()`.
dashPattern : list<real>
Diese Eigenschaft definiert das Strichmuster, wenn „ strokeStyle “ auf „ ShapePath.DashLine“ gesetzt ist. Das Muster muss als gerade Anzahl positiver Einträge angegeben werden, wobei die Einträge 1, 3, 5… die Striche und 2, 4, 6… die Leerzeichen darstellen. Das Muster wird in Einheiten der Stiftbreite angegeben.
Der Standardwert ist (4, 2), was bedeutet, dass ein Strich von 4 * strokeWidth Pixeln auf einen Abstand von 2 * strokeWidth Pixeln folgt.
Siehe auch ` QPen::setDashPattern()`.
fillColor : color
Diese Eigenschaft legt die Füllfarbe fest.
Wenn der Wert auf „ transparent “ gesetzt ist, erfolgt keine Füllung.
Der Standardwert ist „ "white" “.
Hinweis: Wenn „ fillGradient “ auf einen anderen Wert als „ null “ gesetzt ist, wird dieser anstelle von „ fillColor “ verwendet.
fillGradient : ShapeGradient
Der „fillGradient“ der Polygon-Füllfarbe.
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 diese Option gesetzt ist, wird „ fillColor “ ignoriert und die Füllung erfolgt unter Verwendung eines der Untertypen von „ ShapeGradient “.
Hinweis: Der Typ „ Gradient “ kann hier nicht verwendet werden. Verwenden Sie stattdessen lieber einen der erweiterten Untertypen, wie z. B. „ LinearGradient “.
joinStyle : enumeration
Diese Eigenschaft legt fest, wie Verbindungslinien 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 ausgefüllt. |
ShapePath.BevelJoin | Die dreieckige Aussparung zwischen den beiden Linien wird ausgefüllt. |
ShapePath.RoundJoin | Ein Kreisbogen zwischen den beiden Linien wird ausgefüllt. |
Der Parameter „joinStyle“ ist nur dann von Bedeutung, wenn „ cornerRadius “ == 0 ist.
sideCount : int
Die Anzahl der Kanten des regelmäßigen Vielecks. Die Mindestanzahl der Kanten beträgt 3.
Der Standardwert lautet „ 6 “.
strokeColor : color
Diese Eigenschaft legt die Farbe der Kontur fest.
Wenn sie auf „ transparent “ gesetzt ist, wird kein Umriss gezeichnet.
Der Standardwert ist „ "black" “.
strokeStyle : enumeration
Diese Eigenschaft legt den Stil der Konturierung fest. Der Standardwert ist „ ShapePath.SolidLine“.
| Konstante | Beschreibung |
|---|---|
ShapePath.SolidLine | Eine durchgezogene Linie. |
ShapePath.DashLine | Durch einige Pixel voneinander getrennte Striche. |
strokeWidth : real
Diese Eigenschaft legt die Strichbreite fest.
Wird ein negativer Wert festgelegt, erfolgt keine Konturzeichnung.
Der Standardwert lautet „ 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.
