EllipseShape QML Type

Eine Formkomponente, mit der eine Ellipse, ein Bogen oder ein Kreissegment dargestellt werden kann. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• borderMode : enumeration
• capStyle : enumeration
• cornerRadius : real
• dashOffset : real
• dashPattern : list<real>
• fillColor : color
• fillGradient : ShapeGradient
• fillRule : enumeration
• innerArcRatio : real
• joinStyle : enumeration
• startAngle : real
• strokeColor : color
• strokeStyle : enumeration
• strokeWidth : real
• sweepAngle : real

Ausführliche Beschreibung

Das Element „EllipseShape“ zeichnet eine Ellipse, die so angepasst werden kann, dass sie als vollständige Ellipse, als Bogen oder als gefülltes Kreissegment erscheint. Ihr Erscheinungsbild wird durch die Eigenschaften „ startAngle “ und „ sweepAngle “ gesteuert.

Einfache Ellipse

Standardmäßig rendert das Element eine vollständige Ellipse. Der Innenbereich wird mit der Farbe „ fillColor “ gefüllt, und der Umriss wird gemäß den Eigenschaften „ strokeColor “, „ strokeWidth “ und „ strokeStyle “ gezeichnet.

Bogen und Kreissegmente

Um einen Bogen oder ein Kreissegment zu erstellen, legen Sie die Werte für „ startAngle “ (0–360 Grad) und „ sweepAngle “ (0–360 Grad) fest, um den zu zeichnenden Teil der Ellipse zu definieren.

Bogenmodus: Um einen einfachen Bogen (nur die Umrisse) zu erstellen, setzen Sie „ fillColor “ auf „ "transparent" “. Der Linienstil des Bogens kann mit „ dashPattern “ und „ dashOffset “ angepasst werden.

Kuchenscheiben-Modus: Um ein gefülltes Kuchenscheibenstück (ein mit dem Mittelpunkt verbundenes Segment) zu erstellen, stellen Sie einfach den Wert „ fillColor “ ein. Der Umriss des Kuchenscheibenstücks wird ebenfalls mit einer Linie umrandet.

Donut-Modus: Um einen Donut-Ring (eine hohle Ellipse) zu erstellen, setzen Sie die Eigenschaft „ innerArcRatio “ auf einen Wert zwischen 0,0 und 1,0. Dies definiert das Verhältnis des Radius der inneren Ellipse zum Radius der äußeren Ellipse.

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 „ fillGradient “ festgelegt wird. Wenn sowohl eine Farbe als auch ein Farbverlauf angegeben sind, wird der Farbverlauf verwendet.

Einer Ellipse kann ein optionaler Rand mit eigener Farbe und Dicke hinzugefügt werden, indem die Eigenschaften „ strokeColor “ und „ strokeWidth “ festgelegt werden. Durch Setzen der Farbe auf „ transparent “ wird ein Rand ohne Füllfarbe erstellt.

Eine Ellipse kann mithilfe der Eigenschaft „ cornerRadius “ mit abgerundeten Ecken gezeichnet werden. Der Standardwert der Eigenschaft „ cornerRadius “ beträgt 10 Grad.

Der Standardwert von „ QtQuick.Shapes::Shape::preferredRendererType “ für „EllipseShape“ beträgt „ Shape.CurveRenderer “.

Anwendungsbeispiel

    EllipseShape {
        id: ellipseShape
        anchors.fill: parent
        width: 90
        height: 90
        startAngle: 0
        sweepAngle: 270
    }

Dokumentation zur Eigenschaft

borderMode : enumeration

Die Eigenschaft „borderMode“ legt fest, wo der Rahmen entlang der Kante der Ellipse gezeichnet wird.

Dies ist der Standardwert.

Siehe auch „ strokeWidth “.

capStyle : enumeration

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

cornerRadius : real

Steuert die Abrundung der Ecken, an denen die radialen Linien auf die elliptischen Bögen treffen. Bei Kreisdiagrammsegmenten werden dadurch die Übergänge zum äußeren Bogen abgerundet. Bei Ringdiagrammsegmenten werden zudem die Übergänge sowohl zum inneren als auch zum äußeren Bogen abgerundet.

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 sind. 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" “.

fillGradient : ShapeGradient

Der „fillGradient“ der Füllfarbe der Ellipse.

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 “.

fillRule : enumeration

Diese Eigenschaft enthält die Füllregel. Der Standardwert lautet „ ShapePath.OddEvenFill “. Eine Erläuterung zu Füllregeln finden Sie unter QPainterPath::setFillRule().

innerArcRatio : real

Diese Eigenschaft definiert das Verhältnis zwischen dem inneren und dem äußeren Bogen.

Der Wertebereich liegt zwischen 0,0 und 1,0. Wenn der Wert auf 0,0 gesetzt wird, wird der innere Bogen zur Mitte hin zusammengedrückt, wodurch eine vollständig gefüllte Ellipse entsteht. Bei einem Wert von 1,0 hat der innere Bogen dieselbe Größe wie die äußere Ellipse, sodass lediglich ein Bogen entsteht. Werte zwischen 0,0 und 1,0 erzeugen hohle elliptische Ringe.

Der Standardwert ist „ 0 “.

joinStyle : enumeration

Diese Eigenschaft legt fest, wie Verbindungslinien zwischen zwei verbundenen Linien gezeichnet werden. Der Standardwert ist „ ShapePath.BevelJoin “.

startAngle : real

Die Eigenschaft legt den Startwinkel in Grad fest, ab dem die Ellipse gezeichnet wird.

0 Grad zeigt nach oben. Der Winkel nimmt im Uhrzeigersinn zu.

Der Standardwert beträgt „ 0 “.

strokeColor : color

Diese Eigenschaft legt die Farbe der Kontur fest.

Bei der Einstellung „ transparent “ erfolgt keine Konturierung.

Der Standardwert ist „ "black" “.

strokeStyle : enumeration

Diese Eigenschaft legt den Stil der Linienführung fest. Der Standardwert ist „ ShapePath.SolidLine“.

strokeWidth : real

Diese Eigenschaft legt die Strichbreite fest.

Wird ein negativer Wert festgelegt, erfolgt keine Konturzeichnung.

Der Standardwert lautet „ 1 “.

sweepAngle : real

Der Winkel in Grad, der aus dem Parameter „ startAngle “ gezeichnet werden soll.

Bei einem positiven Wert wird der Bogen im Uhrzeigersinn gezeichnet. Bei einem negativen Wert wird der Bogen gegen den Uhrzeigersinn gezeichnet.

Der Standardwert ist „ 360 “.