PathArc QML Type

Definiert einen Bogen mit dem angegebenen Radius. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• direction : enumeration
• radiusX : real
• radiusY : real
• relativeX : real
• relativeY : real
• useLargeArc : bool
• x : real
• xAxisRotation : real
• y : real

Ausführliche Beschreibung

PathArc bietet eine einfache Möglichkeit, einen Bogen zu definieren, der an einer bestimmten Position endet und den angegebenen Radius verwendet. Er ist dem SVG-Befehl „elliptical arc“ nachempfunden.

Der folgende QML-Code erzeugt den unten abgebildeten Pfad:

Path {
    startX: 100; startY: 0

    PathArc {
        x: 0; y: 100
        radiusX: 100; radiusY: 100
        useLargeArc: true
    }
}

Beachten Sie, dass ein einzelnes „PathArc“-Element nicht zur Darstellung eines Kreises verwendet werden kann. Stattdessen können Sie zwei „PathArc“-Elemente verwenden, von denen jedes die Hälfte des Kreises definiert.

Siehe auch Path, PathLine, PathQuad, PathCubic, PathAngleArc, PathCurve und PathSvg.

Dokumentation zu Eigenschaften

direction : enumeration

Legt die Richtung des Bogens fest. Mögliche Werte sind „ PathArc.Clockwise“ (Standard) und „ PathArc.Counterclockwise“.

Der folgende QML-Code kann durch Ändern des Werts von „direction“ einen der beiden unten abgebildeten Bögen erzeugen.

Path {
    startX: 50; startY: 50

    PathArc {
        x: 150; y: 50
        radiusX: 75; radiusY: 50
    }
}

Siehe auch useLargeArc.

Legt den Radius des Bogens fest.

Das folgende QML-Beispiel zeigt, wie sich die Form des Bogens durch unterschiedliche Radiuswerte verändern lässt:

Path {
    startX: 0; startY: 100

    PathArc {
        relativeX: 50; y: 100
        radiusX: 25; radiusY: 15
    }
    PathArc {
        relativeX: 50; y: 100
        radiusX: 25; radiusY: 25
    }
    PathArc {
        relativeX: 50; y: 100
        radiusX: 25; radiusY: 50
    }
    PathArc {
        relativeX: 50; y: 100
        radiusX: 50; radiusY: 100
    }
}

Legt den Endpunkt des Bogens relativ zu seinem Startpunkt fest.

Wenn für eine einzelne Achse sowohl eine relative als auch eine absolute Endposition angegeben werden, wird die relative Position verwendet.

Relative und absolute Positionen können gemischt werden; so ist es beispielsweise zulässig, eine relative x- und eine absolute y-Position festzulegen.

Siehe auch x und y.

useLargeArc : bool

Ob ein großer Bogen verwendet werden soll, der durch die Bogenpunkte definiert ist.

Bei festgelegten Start- und Endpositionen, Radius und Richtung gibt es zwei mögliche Bögen, die zu den Daten passen. Mit „useLargeArc“ wird zwischen diesen unterschieden. Beispielsweise kann der folgende QML-Code durch Ändern des Werts von „useLargeArc“ einen der beiden unten abgebildeten Bögen erzeugen.

Path {
    startX: 0; startY: 100
    PathArc {
        x: 100; y: 200
        radiusX: 100; radiusY: 100
        direction: PathArc.Clockwise
    }
}

Der Standardwert ist „false“.

Legt den Endpunkt des Bogens fest.

Siehe auch relativeX und relativeY.

xAxisRotation : real

Legt die Drehung des Bogens in Grad fest. Der Standardwert ist 0.

Ein Bogen ist ein Ausschnitt aus Kreisen oder Ellipsen. Bei gegebenem Radius sowie Start- und Endpunkt gibt es zwei Ellipsen, die diese Punkte verbinden. Diese Eigenschaft definiert die Drehung um die X-Achse dieser Ellipsen.

Das folgende QML-Beispiel zeigt, wie unterschiedliche Radiuswerte verwendet werden können, um die Form des Bogens zu verändern:

Path {
    startX: 50; startY: 100

    PathArc {
        x: 150; y: 100
        radiusX: 50; radiusY: 20
        xAxisRotation: 45
    }
}