QLine Class

Die Klasse QLine liefert einen zweidimensionalen Vektor mit ganzzahliger Genauigkeit. Mehr...

Kopfzeile: #include <QLine>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Diese Klasse ist gleichsetzbar.

Diese Klasse ist gleichsetzbar mit QLineF.

Öffentliche Funktionen

QLine()
QLine(const QPoint &p1, const QPoint &p2)
QLine(int x1, int y1, int x2, int y2)
QPoint p1() const
QPoint p2() const
int x1() const
int x2() const
int y1() const
int y2() const
QPoint center() const
int dx() const
int dy() const
bool isNull() const
void setP1(const QPoint &p1)
void setP2(const QPoint &p2)
void setLine(int x1, int y1, int x2, int y2)
void setPoints(const QPoint &p1, const QPoint &p2)
(since 6.4) QLineF toLineF() const
void translate(const QPoint &offset)
void translate(int dx, int dy)
QLine translated(const QPoint &offset) const
QLine translated(int dx, int dy) const
bool operator!=(const QLine &lhs, const QLine &rhs)
QDataStream &operator<<(QDataStream &stream, const QLine &line)
bool operator==(const QLine &lhs, const QLine &rhs)
QDataStream &operator>>(QDataStream &stream, QLine &line)

Detaillierte Beschreibung

Eine QLine beschreibt eine Linie endlicher Länge (oder ein Liniensegment) auf einer zweidimensionalen Fläche. Die Anfangs- und Endpunkte der Linie werden mit ganzzahliger Punktgenauigkeit für die Koordinaten angegeben. Verwenden Sie den QLineF Konstruktor, um eine Fließkommakopie zu erhalten.

Die Positionen der Anfangs- und Endpunkte der Linie können mit den Funktionen p1(), x1(), y1(), p2(), x2() und y2() abgerufen werden. Die Funktionen dx() und dy() geben die horizontalen und vertikalen Komponenten der Linie zurück. Verwenden Sie isNull(), um festzustellen, ob die QLine eine gültige Linie oder eine Null-Linie darstellt.

Schließlich kann die Linie mit der Funktion translate() um einen bestimmten Offset verschoben werden.

Siehe auch QLineF, QPolygon, und QRect.

Dokumentation der Mitgliedsfunktionen

[constexpr] QLine::QLine()

Konstruiert eine Null-Linie.

[constexpr] QLine::QLine(const QPoint &p1, const QPoint &p2)

Konstruiert ein Linienobjekt, das die Linie zwischen p1 und p2 darstellt.

[constexpr] QLine::QLine(int x1, int y1, int x2, int y2)

Konstruiert ein Linienobjekt, das die Linie zwischen (x1, y1) und (x2, y2) darstellt.

[constexpr] QPoint QLine::p1() const

Gibt den Startpunkt der Zeile zurück.

Siehe auch setP1(), x1(), y1(), und p2().

[constexpr] QPoint QLine::p2() const

Gibt den Endpunkt der Linie zurück.

Siehe auch setP2(), x2(), y2(), und p1().

[constexpr] int QLine::x1() const

Gibt die x-Koordinate des Startpunkts der Linie zurück.

Siehe auch p1().

[constexpr] int QLine::x2() const

Gibt die x-Koordinate des Endpunkts der Linie zurück.

Siehe auch p2().

[constexpr] int QLine::y1() const

Gibt die y-Koordinate des Startpunkts der Linie zurück.

Siehe auch p1().

[constexpr] int QLine::y2() const

Gibt die y-Koordinate des Endpunkts der Linie zurück.

Siehe auch p2().

[constexpr] QPoint QLine::center() const

Gibt den Mittelpunkt dieser Linie zurück. Dies ist äquivalent zu (p1() + p2()) / 2, mit dem Unterschied, dass es nie überlaufen wird.

[constexpr] int QLine::dx() const

Gibt die horizontale Komponente des Vektors der Linie zurück.

Siehe auch dy().

[constexpr] int QLine::dy() const

Gibt die vertikale Komponente des Vektors der Linie zurück.

Siehe auch dx().

[constexpr] bool QLine::isNull() const

Gibt true zurück, wenn die Linie keine eindeutigen Anfangs- und Endpunkte hat; andernfalls false.

void QLine::setP1(const QPoint &p1)

Setzt den Startpunkt dieser Zeile auf p1.

Siehe auch setP2() und p1().

void QLine::setP2(const QPoint &p2)

Setzt den Endpunkt dieser Zeile auf p2.

Siehe auch setP1() und p2().

void QLine::setLine(int x1, int y1, int x2, int y2)

Setzt diese Zeile auf den Anfang in x1, y1 und das Ende in x2, y2.

Siehe auch setP1(), setP2(), p1(), und p2().

void QLine::setPoints(const QPoint &p1, const QPoint &p2)

Setzt den Startpunkt dieser Zeile auf p1 und den Endpunkt dieser Zeile auf p2.

Siehe auch setP1(), setP2(), p1(), und p2().

[constexpr noexcept, since 6.4] QLineF QLine::toLineF() const

Gibt diese Linie als Linie mit Fließkommagenauigkeit zurück.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch QLineF::toLine().

void QLine::translate(const QPoint &offset)

Übersetzt diese Zeile mit dem angegebenen offset.

void QLine::translate(int dx, int dy)

Dies ist eine überladene Funktion.

Verschiebt diese Zeile um den durch dx und dy angegebenen Abstand.

[constexpr] QLine QLine::translated(const QPoint &offset) const

Gibt diese Zeile übersetzt mit dem angegebenen offset zurück.

[constexpr] QLine QLine::translated(int dx, int dy) const

Dies ist eine überladene Funktion.

Gibt diese Linie übersetzt in der durch dx und dy angegebenen Entfernung zurück.

Verwandte Nicht-Mitglieder

[constexpr noexcept] bool operator!=(const QLine &lhs, const QLine &rhs)

Gibt true zurück, wenn die Zeile lhs nicht mit der Zeile rhs identisch ist.

Eine Zeile unterscheidet sich von einer anderen Zeile, wenn einer ihrer Anfangs- oder Endpunkte unterschiedlich ist oder die interne Reihenfolge der Punkte unterschiedlich ist.

QDataStream &operator<<(QDataStream &stream, const QLine &line)

Schreibt den angegebenen line in den angegebenen stream und gibt eine Referenz auf den Stream zurück.

Siehe auch Serialisierung von Qt-Datentypen.

[constexpr noexcept] bool operator==(const QLine &lhs, const QLine &rhs)

Gibt true zurück, wenn die Zeile lhs mit der Zeile rhs identisch ist.

Eine Zeile ist identisch mit einer anderen Zeile, wenn der Anfangs- und Endpunkt identisch sind und die interne Reihenfolge der Punkte gleich ist.

QDataStream &operator>>(QDataStream &stream, QLine &line)

Liest eine Zeile aus dem angegebenen stream in den angegebenen line und gibt eine Referenz auf den Stream zurück.

Siehe auch Serialisierung von Qt-Datentypen.

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