QPoint Class

Documentation des fonctions membres

[constexpr noexcept] QPoint::QPoint()

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

Voir aussi isNull().

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

Construit un point avec les coordonnées donné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 point de p1 et p2.

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

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

[constexpr] int QPoint::manhattanLength() const

Renvoie la somme des valeurs absolues de x() et y(), traditionnellement connue comme la "longueur de Manhattan" du vecteur de l'origine au point. A titre d'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" vient du fait que ces distances s'appliquent aux voyageurs qui ne peuvent se déplacer que sur une grille rectangulaire, comme les 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 aussi 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 y. Par exemple :

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

Voir aussi y() et setY().

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

Définit la coordonnée x de ce point à la coordonnée x donnée.

Voir également x() et setY().

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

Définit la coordonnée y de ce point à la coordonnée y donnée.

Voir également y() et setX().

[noexcept] CGPoint QPoint::toCGPoint() const

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

Voir aussi QPointF::fromCGPoint().

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

Renvoie ce point en tant que point avec une précision en virgule 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 ont été échangées :

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

Voir aussi x(), y(), setX() et setY().

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

Renvoie la coordonnée x de ce point.

Voir aussi 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 factor, et renvoie une référence à ce point. Par exemple, le résultat est arrondi à l'entier le plus proche :

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 considérés comme des entiers. Utilisez QPointF pour une précision en virgule flottante.

Voir aussi operator/=().

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

Multiplie les coordonnées de ce point par factor, et renvoie une référence à ce point.

Le résultat est arrondi à l'entier le plus proche, car les points sont considérés comme des entiers. Utilisez QPointF pour une précision en virgule flottante.

Voir aussi operator/=().

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

Multiplie les coordonnées de ce point par factor, et renvoie une référence à ce point.

Voir aussi operator/=().

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

Ajoute le site point à 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 la valeur point 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 le point donné divisor, et renvoie une référence à ce point. Par exemple, le résultat est arrondi à l'entier le plus proche :

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 considérés comme des entiers. Utilisez QPointF pour une précision en virgule flottante.

Voir également operator*=().