EllipseShape QML Type

Eine Formkomponente, die eine Ellipse, einen Bogen oder ein Tortenstück darstellen 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

Detaillierte Beschreibung

Mit dem Element EllipseShape wird eine Ellipse gezeichnet, die als vollständige Ellipse, als Bogen oder als gefülltes Tortenstück dargestellt werden kann. Ihr Aussehen wird durch die Eigenschaften startAngle und sweepAngle gesteuert.

Grundlegende Ellipse

Standardmäßig wird das Element als vollständige Ellipse dargestellt. Der Innenraum wird mit fillColor gefüllt, und der Umriss wird gemäß den Eigenschaften strokeColor, strokeWidth und strokeStyle gezeichnet.

Bögen und Tortenstücke

Um einen Bogen oder ein Tortenstück zu erstellen, legen Sie die startAngle (0-360 Grad) und sweepAngle (0-360 Grad) fest, um das zu zeichnende Segment der Ellipse zu definieren.

Bogen-Modus: Um einen einfachen Bogen (nur den Umriss) zu erstellen, setzen Sie fillColor auf "transparent". Der Linienstil des Bogens kann mit dashPattern und dashOffset angepasst werden.

Kuchenmodus: Um ein gefülltes Tortenstück (ein mit der Mitte verbundenes Segment) zu erstellen, setzen Sie einfach fillColor. Der Umriss des Stücks wird ebenfalls gestrichelt.

Donut-Modus: Um einen Donut-Ring (eine hohle Ellipse) zu erstellen, setzen Sie den innerArcRatio auf einen Wert zwischen 0,0 und 1,0. Damit wird das Verhältnis zwischen dem Radius der inneren Ellipse und dem Radius der äußeren Ellipse festgelegt.

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

Ein optionaler Rand kann einer Ellipse mit eigener Farbe und Dicke hinzugefügt werden, indem die Eigenschaften strokeColor und strokeWidth eingestellt werden. Wenn Sie die Farbe auf transparent setzen, wird ein Rahmen ohne Füllfarbe erzeugt.

Mit der Eigenschaft cornerRadius können Ellipsen mit abgerundeten Ecken gezeichnet werden. Der Standardwert von cornerRadius ist 10 Grad.

Der Standardwert von EllipseShape für QtQuick.Shapes::Shape::preferredRendererType ist Shape.CurveRenderer.

Beispielverwendung

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

Eigenschaft Dokumentation

borderMode : enumeration

Die Eigenschaft borderMode legt fest, wo der Rand 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, wo die radialen Linien auf die elliptischen Bögen treffen. Bei Tortensegmenten wird die Verbindung zum äußeren Bogen abgerundet. Bei Donut-Segmenten werden auch die Verbindungen zu den inneren und äußeren Bögen abgerundet.

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

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 der Wert fillColor gesetzt ist, wird er ignoriert und die Füllung erfolgt mit einem der ShapeGradient Untertypen.

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().

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. Wird der Wert auf 0,0 gesetzt, fällt der innere Bogen zur Mitte hin zusammen, so dass eine ausgefüllte Ellipse gezeichnet wird. Bei einem Wert von 1,0 hat der innere Bogen die gleiche Größe wie die äußere Ellipse, so dass nur 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 Verbindungen zwischen zwei verbundenen Linien gezeichnet werden. Der Standardwert ist ShapePath.BevelJoin.

startAngle : real

Die Eigenschaft definiert den Startwinkel in Grad, ab dem die Ellipse gezeichnet werden soll.

0 Grad zeigt auf die Spitze. Der Winkel nimmt im Uhrzeigersinn zu.

Der Standardwert ist 0.

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.

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.

sweepAngle : real

Die Winkelausdehnung in Grad, die von startAngle aus gezeichnet werden soll.

Bei einem positiven Wert wird der Bogen im Uhrzeigersinn gezeichnet. Bei einem negativen Wert wird der Bogen entgegen dem Uhrzeigersinn gezeichnet.

Der Standardwert ist 360.