QPoint Class

Dokumentation zu den Mitgliedsfunktionen

[constexpr noexcept] QPoint::QPoint()

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

Siehe auch „ isNull()“.

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

Erzeugt 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 Skalarprodukt von p1 und p2 zurück.

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

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

[constexpr] int QPoint::manhattanLength() const

Gibt die Summe der Absolutwerte von ` x()` und ` y()` zurück, die traditionell als „Manhattan-Länge“ des Vektors vom Ursprung zum Punkt bezeichnet wird. Zum Beispiel:

QPoint oldPosition;

void 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 eine nützliche und schnell zu berechnende Annäherung an die tatsächliche 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 Raster bewegen können, wie beispielsweise auf den Straßen von Manhattan.

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

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

Durch die Verwendung einer Referenz ist es möglich, `x` direkt zu manipulieren. 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.

Durch die Verwendung einer Referenz ist es möglich, y direkt zu bearbeiten. 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

Erstellt einen CGPoint aus einem „ QPoint “.

Siehe auch QPointF::fromCGPoint().

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

Gibt diesen Punkt als Punkt mit Gleitkommagenauigkeit zurück.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch „ QPointF::toPoint()“.

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

Gibt einen Punkt zurück, bei dem die x- und y-Koordinaten vertauscht sind:

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 Wert „ factor “ und gibt eine Referenz auf diesen Punkt zurück. Beispiel:

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

Beachten Sie, dass das Ergebnis auf die nächste ganze Zahl gerundet wird, da Punkte als Ganzzahlen gespeichert werden. Verwenden Sie ` QPointF ` für Gleitkommagenauigkeit.

Siehe auch ` operator/=()`.

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

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

Beachten Sie, dass das Ergebnis auf die nächste ganze Zahl gerundet wird, da Punkte als Ganzzahlen gespeichert werden. Verwenden Sie ` QPointF ` für Gleitkommagenauigkeit.

Siehe auch ` operator/=()`.

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

Multipliziert die Koordinaten dieses Punktes mit dem angegebenen Wert „ factor “ und gibt eine Referenz auf diesen Punkt zurück.

Siehe auch ` operator/=()`.

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

Fügt die angegebene ` point ` zu diesem Punkt hinzu und gibt eine Referenz 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 eine Referenz auf diesen Punkt zurück. Beispiel:

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

Siehe auch ` operator+=()`.

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

Teilt sowohl x als auch y durch den angegebenen Wert divisor und gibt eine Referenz auf diesen Punkt zurück. Beispiel:

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

Beachten Sie, dass das Ergebnis auf die nächste ganze Zahl gerundet wird, da Punkte als Ganzzahlen gespeichert werden. Verwenden Sie ` QPointF ` für Gleitkommagenauigkeit.

Siehe auch ` operator*=()`.