Path QML Type

Definiert einen Pfad zur Verwendung durch PathView und Shape. Mehr...

Import Statement:	`import QtQuick`
Inherited By:	ShapePath

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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)

Detaillierte Beschreibung

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

Die Abstände der Elemente entlang des Pfades können über ein PathPercent Objekt angepasst werden.

PathAttribute erlaubt es, benannte Attribute mit Werten entlang des Pfades zu definieren.

Path und die anderen Typen zur Angabe von Pfadelementen werden von PathView und Shape gemeinsam genutzt. Die folgende Tabelle gibt einen Überblick über die Anwendbarkeit der verschiedenen Pfadelemente:

Element	PathView	Form	Form, Software
PathMove	K.A.	Ja	Ja
PathLine	Ja	Ja	Ja
PathPolyline	Ja	Ja	Ja
PathMultiline	Ja	Ja	Ja
PathQuad	Ja	Ja	Ja
PathCubic	Ja	Ja	Ja
PathArc	Ja	Ja	Ja
PathAngleArc	Ja	Ja	Ja
PathSvg	Ja	Ja	Ja
PathRectangle	Ja	Ja	Ja
PathAttribute	Ja	K.A.	NICHT ZUTREFFEND
PathPercent	Ja	N/A	N/A
PathCurve	Ja	Nein	Nein

Hinweis: Der Pfad ist ein nicht-visueller Typ; er zeigt nichts von selbst an. Um einen Pfad zu zeichnen, verwenden Sie Shape.

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

Eigenschaft Dokumentation

startX : real

startY : real

Diese Eigenschaften geben die Startposition des Pfades an.

closed : bool [read-only]

Diese Eigenschaft gibt an, ob der Anfang und das Ende des Pfades identisch sind.

pathElements : list<PathElement> [default]

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

Ein Pfad kann die folgenden Pfadobjekte enthalten:

PathLine - eine gerade Linie zu einer bestimmten Position.
PathPolyline - eine Polylinie, die als Liste von Koordinaten angegeben wird.
PathMultiline - eine Liste von Polylinien, die als eine Liste von Koordinatenlisten angegeben wird.
PathQuad - eine quadratische Bezier-Kurve zu einer gegebenen Position mit einem Kontrollpunkt.
PathCubic - eine kubische Bezier-Kurve zu einer gegebenen Position mit zwei Kontrollpunkten.
PathArc - ein Bogen zu einer gegebenen Position mit einem Radius.
PathAngleArc - ein Bogen, der durch Mittelpunkt, Radien und Winkel angegeben wird.
PathSvg - ein als SVG-Pfaddatenstring angegebener Pfad.
PathRectangle - ein Rechteck mit einer bestimmten Position und Größe
PathCurve - ein Punkt auf einer Catmull-Rom-Kurve.
PathAttribute - ein Attribut an einer bestimmten Position im 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 erreichen.

Hinweis: Die Einstellung dieser Eigenschaft hat keinen Einfluss auf die Breite des Rahmens.

Diese Eigenschaft wurde in QtQuick 2.14 eingeführt.

simplify : bool [since 6.6]

Wenn sie auf true gesetzt ist, wird der Pfad vereinfacht. Dies bedeutet, dass alle Unterpfade, die sich kreuzen, zusammengeführt werden, so dass ein Pfad entsteht, der keine Selbstüberschneidungen aufweist. Aufeinanderfolgende parallele Linien werden ebenfalls zusammengeführt. Der vereinfachte Pfad ist für die Verwendung mit ShapePath.OddEvenFill vorgesehen. Bezier-Kurven können aufgrund der numerischen Instabilität bei der Durchführung von Bezier-Kurvenschnittpunkten zu Liniensegmenten abgeflacht werden.

Diese Eigenschaft wurde in Qt 6.6 eingeführt.

Dokumentation der Methode

[since QtQuick 2.14] point pointAtPercent(real t)

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

Hinweis: Ähnlich wie bei anderen Prozent-Methoden in QPainterPath ist die Messung des Prozentsatzes nicht linear in Bezug auf die Länge, wenn Kurven im Pfad vorhanden sind. Wenn Kurven vorhanden sind, wird das Prozent-Argument auf den t Parameter der Bezier-Gleichungen abgebildet.

Diese Methode wurde in QtQuick 2.14 eingeführt.

Siehe auch QPainterPath::pointAtPercent().

© 2025 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.