Konzepte – Visuelle Koordinaten in Qt Quick

Elementkoordinaten

Das in „ Qt Quick “ standardmäßig verwendete visuelle Koordinatensystem sind die Elementkoordinaten. Dabei handelt es sich um ein kartesisches Koordinatensystem, bei dem (0,0) an der oberen linken Ecke des Elements liegt. Die x-Achse verläuft nach rechts und die y-Achse nach unten, sodass die untere rechte Ecke des Elements bei den Koordinaten (Breite, Höhe) liegt.

Die Position eines einzelnen Elements wird relativ zum Koordinatensystem seines übergeordneten Elements angegeben. Das bedeutet, dass beim Auslesen von x- und y-Werten von Elementen, die keine Geschwisterelemente sind, unter Umständen eine Umrechnung erforderlich ist, um sie in dasselbe Koordinatensystem zu übertragen. In solchen Fällen werden häufig Szenekoordinaten als Zwischenkoordinatensystem verwendet.

Szenenkoordinaten

Szenenkoordinaten sind Koordinaten, bei denen (0,0) der oberen linken Ecke des Fensters entspricht, in dem die Szene gerade gerendert wird. Szenenkoordinaten stimmen in der Regel mit den Elementkoordinaten des Stammelements im Fenster überein.

Sie können von Elementkoordinaten in Szenekoordinaten umrechnen, indem Sie die Funktionen des Elements verwenden, dessen Koordinatensystem Sie interessiert. Unter Item::mapFromItem und Item::mapToItem finden Sie Informationen zur Umrechnung in Szenekoordinaten oder in die Koordinaten eines anderen Elements.

Beispiel

Der folgende QML-Code erstellt eine Anordnung von Quadraten, denen zur Kennzeichnung von Punkten Punkte hinzugefügt wurden:

Rectangle {
    width: 200
    height: 200
    color: "red"

    Rectangle {
        x: 100
        y: 100
        width: 100
        height: 100
        color: "blue"

        Rectangle {
            width: 50
            height: 50
            color: "green"
        }
    }
}

In dieser Abbildung befindet sich der schwarze Punkt an der Position (0,0) innerhalb der Elementkoordinaten des roten Rechtecks. Wäre das rote Rechteck das Stammelement der Szene, befände sich der schwarze Punkt auch in Szenenkoordinaten an der Position (0,0).

Das blaue Rechteck befindet sich am weißen Punkt (100, 100), bezogen auf die obere linke Ecke des roten Rechtecks.

Für das grüne Rechteck sind keine x- und y-Koordinaten angegeben, daher liegt seine Position standardmäßig bei (0,0). Da es sich in den Koordinaten seines übergeordneten Elements, des blauen Rechtecks, bei (0,0) befindet, ist es an der oberen linken Ecke dieses Rechtecks positioniert. Dies ist derselbe Punkt wie der weiße Punkt bei (100,100) in den Koordinaten des roten Rechtecks.