Auf dieser Seite

StarShape QML Type

Ein gefülltes sternförmiges Polygon mit einem optionalen Rand. Mehr...

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

Eigenschaften

Ausführliche Beschreibung

Ein Stern kann ein sternfö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.

Stellen Sie die Eigenschaft pointCount zwischen 3 und 60 ein, um die Anzahl der Punkte des Sterns festzulegen. Stellen Sie die Eigenschaft ratio zwischen 0,1 und 1 ein, um den Abstand der inneren Punkte des Sterns vom Zentrum festzulegen.

Der Bereich innerhalb des Strichs wird entweder mit einer Volltonfarbe, die mit der Eigenschaft fillColor angegeben wird, oder mit einem Farbverlauf, der mit einem der ShapeGradient Untertypen definiert und mit der Eigenschaft gradient eingestellt wird, gezeichnet. Wenn sowohl eine Farbe als auch ein Farbverlauf angegeben sind, wird der Farbverlauf verwendet.

Um einen Stern mit einem Strich zu erstellen, setzen Sie die Eigenschaft strokeWidth auf einen Wert größer als 0. Die Eigenschaft strokeWidth gibt die Breite des Polygonstrichs an. Der Standardwert pointCount 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 Sternecken abgerundet sind.

Dokumentation der Eigenschaft

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.

Da ein Stern gezeichnet wird, bildet der Pfad eine Schleife ohne Linienendpunkte. Daher wird capStyle nur benötigt, wenn strokeStyle == ShapePath.DashLine

cornerRadius : real

Die Eigenschaft steuert die Rundung sowohl der äußeren als auch der inneren Punkte des Sterns.

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 Sternfü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 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.

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.

Der joinStyle ist nur sinnvoll, wenn cornerRadius == 0.

pointCount : int

Die Eigenschaft definiert die Gesamtzahl der Punkte, die der Stern hat.

Der Standardwert ist 6.

ratio : real

Die Eigenschaft definiert den Abstand der inneren Punkte des Sterns vom Zentrum.

Der Standardwert ist 0.5.

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.

KonstanteBeschreibung
ShapePath.SolidLineEine einfache Linie.
ShapePath.DashLineStriche, 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.