QPoint Class

Dokumentation der Mitgliedsfunktionen

[constexpr noexcept] QPoint::QPoint()

Konstruiert einen Nullpunkt, d. h. mit den Koordinaten (0, 0)

Siehe auch isNull().

[constexpr noexcept] QPoint::QPoint(int xpos, int ypos)

Konstruiert einen Punkt mit den angegebenen Koordinaten (xpos, ypos).

Siehe auch setX() und setY().

[static constexpr] int QPoint::dotProduct(const QPoint &p1, const QPoint &p2)

QPoint p( 3, 7);
QPoint q(-1, 4);
int dotProduct = QPoint::dotProduct(p, q);   // dotProduct becomes 25

Gibt das Punktprodukt von p1 und p2 zurück.

[constexpr noexcept] bool QPoint::isNull() const

Gibt true zurück, wenn sowohl die x- als auch die y-Koordinaten auf 0 gesetzt sind, andernfalls false.

[constexpr] int QPoint::manhattanLength() const

Gibt die Summe der absoluten Werte von x() und y() zurück, traditionell bekannt als die "Manhattan-Länge" des Vektors vom Ursprung zum Punkt. Ein Beispiel:

QPoint oldPosition;

MyWidget::mouseMoveEvent(QMouseEvent *event)
{
    QPoint point = event->pos() - oldPosition;
    if (point.manhattanLength() > 3)
        // the mouse has moved more than 3 pixels since the oldPosition
}

Dies ist ein nützlicher und schnell zu berechnender Näherungswert für die wahre Länge:

double trueLength = std::sqrt(std::pow(x(), 2) + std::pow(y(), 2));

Die Tradition der "Manhattan-Länge" rührt daher, dass solche Entfernungen für Reisende gelten, die sich nur auf einem rechteckigen Gitter bewegen können, wie die Straßen von Manhattan.

[constexpr noexcept] int &QPoint::rx()

Gibt eine Referenz auf die x-Koordinate dieses Punktes zurück.

Die Verwendung eines Verweises ermöglicht eine direkte Manipulation von x. Zum Beispiel:

QPoint p(1, 2);
p.rx()--;   // p becomes (0, 2)

Siehe auch x() und setX().

[constexpr noexcept] int &QPoint::ry()

Gibt eine Referenz auf die y-Koordinate dieses Punktes zurück.

Die Verwendung eines Verweises ermöglicht eine direkte Manipulation von y. Zum Beispiel:

QPoint p(1, 2);
p.ry()++;   // p becomes (1, 3)

Siehe auch y() und setY().

[constexpr noexcept] void QPoint::setX(int x)

Setzt die x-Koordinate dieses Punktes auf die angegebene x Koordinate.

Siehe auch x() und setY().

[constexpr noexcept] void QPoint::setY(int y)

Setzt die y-Koordinate dieses Punktes auf die angegebene y Koordinate.

Siehe auch y() und setX().

[noexcept] CGPoint QPoint::toCGPoint() const

Erzeugt einen CGPoint aus einem QPoint.

Siehe auch QPointF::fromCGPoint().

[constexpr noexcept, since 6.4] QPointF QPoint::toPointF() const

Gibt diesen Punkt als Punkt mit Fließkommagenauigkeit zurück.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch QPointF::toPoint().

[constexpr noexcept] QPoint QPoint::transposed() const

Gibt einen Punkt mit ausgetauschten x- und y-Koordinaten zurück:

QPoint{1, 2}.transposed() // {2, 1}

Siehe auch x(), y(), setX(), und setY().

[constexpr noexcept] int QPoint::x() const

Gibt die x-Koordinate dieses Punktes zurück.

Siehe auch setX() und rx().

[constexpr noexcept] int QPoint::y() const

Gibt die y-Koordinate dieses Punktes zurück.

Siehe auch setY() und ry().

[constexpr] QPoint &QPoint::operator*=(double factor)

Multipliziert die Koordinaten dieses Punktes mit dem angegebenen factor und gibt einen Verweis auf diesen Punkt zurück. Ein Beispiel:

QPoint p(-1, 4);
p *= 2.5;    // p becomes (-3, 10)

Beachten Sie, dass das Ergebnis auf die nächste Ganzzahl gerundet wird, da die Punkte als Ganzzahlen gespeichert werden. Verwenden Sie QPointF für Fließkommagenauigkeit.

Siehe auch operator/=().

[constexpr] QPoint &QPoint::operator*=(float factor)

Multipliziert die Koordinaten dieses Punktes mit dem angegebenen factor und gibt einen Verweis auf diesen Punkt zurück.

Beachten Sie, dass das Ergebnis auf die nächste Ganzzahl gerundet wird, da Punkte als Ganzzahlen gespeichert werden. Verwenden Sie QPointF für Fließkommagenauigkeit.

Siehe auch operator/=().

[constexpr] QPoint &QPoint::operator*=(int factor)

Multipliziert die Koordinaten dieses Punktes mit dem angegebenen factor und gibt einen Verweis auf diesen Punkt zurück.

Siehe auch operator/=().

[constexpr] QPoint &QPoint::operator+=(const QPoint &point)

Fügt den angegebenen point zu diesem Punkt hinzu und gibt einen Verweis auf diesen Punkt zurück. Zum Beispiel:

QPoint p( 3, 7);
QPoint q(-1, 4);
p += q;    // p becomes (2, 11)

Siehe auch operator-=().

[constexpr] QPoint &QPoint::operator-=(const QPoint &point)

Subtrahiert den angegebenen point von diesem Punkt und gibt einen Verweis auf diesen Punkt zurück. Zum Beispiel:

QPoint p( 3, 7);
QPoint q(-1, 4);
p -= q;    // p becomes (4, 3)

Siehe auch operator+=().

[constexpr] QPoint &QPoint::operator/=(qreal divisor)

Dies ist eine überladene Funktion.

Teilt sowohl x als auch y durch den angegebenen divisor und gibt einen Verweis auf diesen Punkt zurück. Ein Beispiel:

QPoint p(-3, 10);
p /= 2.5;           // p becomes (-1, 4)

Beachten Sie, dass das Ergebnis auf die nächste Ganzzahl gerundet wird, da die Punkte als Ganzzahlen gehalten werden. Verwenden Sie QPointF für Fließkommagenauigkeit.

Siehe auch operator*=().