QPoint Class

Documentation des fonctions membres

[constexpr noexcept] QPoint::QPoint()

Crée un point nul, c'est-à-dire dont les coordonnées sont (0, 0)

Voir aussi isNull().

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

Crée un point aux coordonnées indiquées (xpos, ypos).

Voir également setX() et 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

Renvoie le produit scalaire de p1 et p2.

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

Renvoie « true » si les coordonnées x et y sont toutes deux égales à 0 ; sinon, renvoie « false ».

[constexpr] int QPoint::manhattanLength() const

Renvoie la somme des valeurs absolues de x() et y(), communément appelée « longueur de Manhattan » du vecteur reliant l'origine au point. Par exemple :

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
    }
}

Il s'agit d'une approximation utile et rapide à calculer de la longueur réelle :

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

La tradition de la « longueur de Manhattan » trouve son origine dans le fait que ces distances s'appliquent aux voyageurs qui ne peuvent se déplacer que sur une grille rectangulaire, à l'image des rues de Manhattan.

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

Renvoie une référence à la coordonnée x de ce point.

L'utilisation d'une référence permet de manipuler directement x. Par exemple :

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

Voir également x() et setX().

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

Renvoie une référence à la coordonnée y de ce point.

L'utilisation d'une référence permet de manipuler directement la valeur y. Par exemple :

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

Voir également y() et setY().

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

Définit la coordonnée x de ce point sur la coordonnée x fournie.

Voir également x() et setY().

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

Définit la coordonnée y de ce point sur la coordonnée y fournie.

Voir également y() et setX().

[noexcept] CGPoint QPoint::toCGPoint() const

Crée un objet `CGPoint` à partir d'un objet ` QPoint`.

Voir aussi QPointF::fromCGPoint().

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

Renvoie ce point sous la forme d'un point à précision flottante.

Cette fonction a été introduite dans Qt 6.4.

Voir aussi QPointF::toPoint().

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

Renvoie un point dont les coordonnées x et y sont inversées :

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

Voir également x(), y(), setX() et setY().

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

Renvoie la coordonnée x de ce point.

Voir également setX() et rx().

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

Renvoie la coordonnée y de ce point.

Voir aussi setY() et ry().

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

Multiplie les coordonnées de ce point par l'factor e spécifiée et renvoie une référence à ce point. Par exemple :

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

Notez que le résultat est arrondi à l'entier le plus proche, car les points sont représentés sous forme d'entiers. Utilisez ` QPointF ` pour obtenir une précision en virgule flottante.

Voir également operator/=().

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

Multiplie les coordonnées de ce point par l'factor e spécifiée et renvoie une référence à ce point.

Notez que le résultat est arrondi à l'entier le plus proche, car les points sont stockés sous forme d'entiers. Utilisez ` QPointF ` pour obtenir une précision en virgule flottante.

Voir également la fonction ` operator/=()`.

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

Multiplie les coordonnées de ce point par l'factor e spécifiée et renvoie une référence à ce point.

Voir aussi operator/=().

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

Ajoute l'point on indiquée à ce point et renvoie une référence à ce point. Par exemple :

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

Voir aussi operator-=().

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

Soustrait l'point on indiquée de ce point et renvoie une référence à ce point. Par exemple :

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

Voir aussi ` operator+=()`.

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

Divise à la fois x et y par l'divisor donnée, puis renvoie une référence à ce point. Par exemple :

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

Notez que le résultat est arrondi à l'entier le plus proche, car les points sont stockés sous forme d'entiers. Utilisez ` QPointF ` pour obtenir une précision en virgule flottante.

Voir également operator*=().