Path QML Type

Definiert einen Pfad, der von „ PathView “ und „ Shape “ verwendet wird. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• asynchronous : bool (since 6.9)
• closed : bool
• pathElements : list<PathElement>
• scale : size (since QtQuick 2.14)
• simplify : bool (since 6.6)
• startX : real
• startY : real

Methoden

• point pointAtPercent(real t) (since QtQuick 2.14)

Ausführliche Beschreibung

Ein Pfad besteht aus einem oder mehreren Pfadsegmenten – PathLine, PathPolyline, PathQuad, PathCubic, PathArc, PathAngleArc, PathCurve, PathSvg.

Der Abstand der Elemente entlang des Pfads kann über ein „ PathPercent “-Objekt angepasst werden.

PathAttribute Ermöglicht die Definition benannter Attribute mit Werten entlang des Pfades.

„Path“ und die anderen Typen zur Angabe von Pfadelementen werden sowohl von „ PathView “ als auch von „ Shape “ verwendet. Die folgende Tabelle bietet einen Überblick über die Anwendbarkeit der verschiedenen Pfadelemente:

Siehe auch „ PathView“ , „ Shape “, „ PathAttribute “, „ PathPercent “, „ PathLine “, „ PathPolyline “, „ PathMove “, „ PathQuad “, „ PathCubic “, „ PathArc “, „ PathAngleArc “, „ PathCurve “, „ PathSvg “ und „ PathRectangle “.

Dokumentation zu Eigenschaften

asynchronous : bool [since 6.9]

Wenn dieser Wert auf „true“ gesetzt ist, wird der Pfad asynchron verarbeitet. Dies ist eine Optimierung, um den Pfad erst einmalig zu verarbeiten, und zwar nachdem alle Methoden ausgeführt wurden, die den Pfad möglicherweise beeinflussen. Das bedeutet, dass bei der Einstellung „ true “ der aktualisierte Pfad nicht sofort verfügbar ist, nachdem beispielsweise „ startX “, „ scale “ angepasst oder ein Element angehängt wurde, sondern erst, nachdem die Qt-Ereignisschleife abgearbeitet wurde. Der Standardwert ist „ false “.

Diese Eigenschaft wurde in Qt 6.9 eingeführt.

closed : bool [read-only]

Diese Eigenschaft gilt unabhängig davon, ob Anfang und Ende des Pfades identisch sind.

pathElements : list<PathElement> [default read-only]

Diese Eigenschaft enthält die Objekte, aus denen sich der Pfad zusammensetzt.

Ein Pfad kann die folgenden Pfadobjekte enthalten:

• PathLine - eine gerade Linie zu einer bestimmten Position.
• PathPolyline - eine Polylinie, die als Liste von Koordinaten angegeben ist.
• PathMultiline - eine Liste von Polylinien, die als Liste von Koordinatenlisten angegeben ist.
• PathQuad - eine quadratische Bézier-Kurve zu einer bestimmten Position mit einem Kontrollpunkt.
• PathCubic - eine kubische Bézier-Kurve zu einer bestimmten Position mit zwei Kontrollpunkten.
• PathArc - einen Bogen zu einer bestimmten Position mit einem Radius.
• PathAngleArc - Ein Bogen, der durch Mittelpunkt, Radien und Winkel angegeben wird.
• PathSvg - Ein Pfad, der als SVG-Pfaddaten-Zeichenkette angegeben wird.
• PathRectangle - Ein Rechteck mit einer vorgegebenen Position und Größe
• PathCurve - Ein Punkt auf einer Catmull-Rom-Kurve.
• PathAttribute - Ein Attribut an einer bestimmten Position auf dem Pfad.
• PathPercent - eine Möglichkeit, Elemente entlang verschiedener Segmente des Pfades zu verteilen.

    PathView {
        anchors.fill: parent
        model: ContactModel {}
        delegate: delegate
        path: Path {
            startX: 120; startY: 100
            PathAttribute { name: "iconScale"; value: 1.0 }
            PathAttribute { name: "iconOpacity"; value: 1.0 }
            PathQuad { x: 120; y: 25; controlX: 260; controlY: 75 }
            PathAttribute { name: "iconScale"; value: 0.3 }
            PathAttribute { name: "iconOpacity"; value: 0.5 }
            PathQuad { x: 120; y: 100; controlX: -20; controlY: 75 }
        }
    }

scale : size [since QtQuick 2.14]

Diese Eigenschaft enthält den Skalierungsfaktor für den Pfad. Die Breite und Höhe von „ scale “ können unterschiedlich sein, um eine anisotrope Skalierung zu erzielen.

Diese Eigenschaft wurde in QtQuick 2.14 eingeführt.

simplify : bool [since 6.6]

Wenn dieser Wert auf „true“ gesetzt ist, wird der Pfad vereinfacht. Dies bedeutet, dass alle sich schneidenden Teilpfade zusammengeführt werden, sodass ein Pfad entsteht, der keine Selbstschnittstellen enthält. Auch aufeinanderfolgende parallele Linien werden zusammengeführt. Der vereinfachte Pfad ist für die Verwendung mit „ ShapePath.OddEvenFill“ vorgesehen. Bézier-Kurven können aufgrund numerischer Instabilitäten bei der Berechnung von Schnittpunkten von Bézier-Kurven zu Liniensegmenten vereinfacht werden.

Diese Eigenschaft wurde in Qt 6.6 eingeführt.

Diese Eigenschaften geben die Startposition des Pfades an.

Methodendokumentation

[since QtQuick 2.14] point pointAtPercent(real t)

Gibt den Punkt am prozentualen t des aktuellen Pfades zurück. Das Argument t muss zwischen 0 und 1 liegen.

Diese Methode wurde in QtQuick 2.14 eingeführt.

Siehe auch QPainterPath::pointAtPercent().