Sur cette page

QPointF Class

La classe QPointF définit un point dans le plan en utilisant la précision de la virgule flottante. Plus d'informations...

En-tête : #include <QPointF>
CMake : find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake : QT += core

Cette classe est comparable à l 'égalité.

Cette classe est comparable à QPoint.

Remarque : Toutes les fonctions de cette classe sont réentrantes.

Fonctions publiques

QPointF()
QPointF(const QPoint &point)
QPointF(qreal xpos, qreal ypos)
bool isNull() const
qreal manhattanLength() const
qreal &rx()
qreal &ry()
void setX(qreal x)
void setY(qreal y)
CGPoint toCGPoint() const
QPoint toPoint() const
QPointF transposed() const
qreal x() const
qreal y() const
QPointF &operator*=(qreal factor)
QPointF &operator+=(const QPointF &point)
QPointF &operator-=(const QPointF &point)
QPointF &operator/=(qreal divisor)

Membres publics statiques

qreal dotProduct(const QPointF &p1, const QPointF &p2)
QPointF fromCGPoint(CGPoint point)
(since 6.8) bool qFuzzyCompare(const QPointF &p1, const QPointF &p2)
(since 6.8) bool qFuzzyIsNull(const QPointF &point)
bool operator!=(const QPointF &lhs, const QPointF &rhs)
QPointF operator*(const QPointF &point, qreal factor)
QPointF operator*(qreal factor, const QPointF &point)
QPointF operator+(const QPointF &point)
QPointF operator+(const QPointF &p1, const QPointF &p2)
QPointF operator-(const QPointF &p1, const QPointF &p2)
QPointF operator-(const QPointF &point)
QPointF operator/(const QPointF &point, qreal divisor)
QDataStream &operator<<(QDataStream &stream, const QPointF &point)
bool operator==(const QPointF &lhs, const QPointF &rhs)
QDataStream &operator>>(QDataStream &stream, QPointF &point)

Description détaillée

Un point est spécifié par une coordonnée x et une coordonnée y auxquelles on peut accéder à l'aide des fonctions x() et y(). Les coordonnées du point sont spécifiées en utilisant des nombres à virgule flottante finie pour plus de précision. La fonction isNull() renvoie true si x et y valent tous deux 0,0. Les coordonnées peuvent être définies (ou modifiées) à l'aide des fonctions setX() et setY(), ou des fonctions rx() et ry() qui renvoient des références aux coordonnées (ce qui permet de les manipuler directement).

Étant donné un point p, les déclarations suivantes sont toutes équivalentes :

QPointF p;

p.setX(p.x() + 1.0);
p += QPointF(1.0, 0.0);
p.rx()++;

Un objet QPointF peut également être utilisé comme vecteur : L'addition et la soustraction sont définies comme pour les vecteurs (chaque composante est ajoutée séparément). Un objet QPointF peut également être divisé ou multiplié par int ou qreal.

En outre, la classe QPointF fournit un constructeur qui convertit un objet QPoint en un objet QPointF, ainsi qu'une fonction toPoint() correspondante qui renvoie une copie QPoint de ce point. Enfin, les objets QPointF peuvent être transmis en continu et comparés.

Voir également QPoint et QPolygonF.

Documentation des fonctions membres

[constexpr noexcept] QPointF::QPointF()

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

Voir aussi isNull().

[constexpr noexcept] QPointF::QPointF(const QPoint &point)

Construit une copie de l'adresse point donnée.

Voir aussi toPoint() et QPoint::toPointF().

[constexpr noexcept] QPointF::QPointF(qreal xpos, qreal ypos)

Construit un point avec les coordonnées données (xpos, ypos).

Voir également setX() et setY().

[static constexpr] qreal QPointF::dotProduct(const QPointF &p1, const QPointF &p2)

QPointF p( 3.1, 7.1);
QPointF q(-1.0, 4.1);
qreal dotProduct = QPointF::dotProduct(p, q);   // dotProduct becomes 26.01

Renvoie le produit point de p1 et p2.

[static noexcept] QPointF QPointF::fromCGPoint(CGPoint point)

Crée un QRectF à partir du CGPoint point.

Voir aussi toCGPoint().

[noexcept] bool QPointF::isNull() const

Renvoie true si les coordonnées x et y sont toutes deux définies sur 0,0 (sans tenir compte du signe) ; sinon, renvoie false.

[constexpr] qreal QPointF::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.

Voir également QPoint::manhattanLength().

[constexpr noexcept] qreal &QPointF::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 :

QPointF p(1.1, 2.5);
p.rx()--;   // p becomes (0.1, 2.5)

Voir aussi x() et setX().

[constexpr noexcept] qreal &QPointF::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 :

QPointF p(1.1, 2.5);
p.ry()++;   // p becomes (1.1, 3.5)

Voir aussi y() et setY().

[constexpr noexcept] void QPointF::setX(qreal x)

Fixe la coordonnée x de ce point à la coordonnée finie x donnée.

Voir aussi x() et setY().

[constexpr noexcept] void QPointF::setY(qreal y)

Fixe la coordonnée y de ce point à la coordonnée finie y donnée.

Voir aussi y() et setX().

[noexcept] CGPoint QPointF::toCGPoint() const

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

Voir aussi fromCGPoint().

[constexpr] QPoint QPointF::toPoint() const

Arrondit les coordonnées de ce point à l'entier le plus proche et renvoie un objet QPoint avec les coordonnées arrondies.

Voir aussi QPointF() et QPoint::toPointF().

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

Renvoie un point dont les coordonnées x et y ont été échangées :

QPointF{1.0, 2.0}.transposed() // {2.0, 1.0}

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

[constexpr noexcept] qreal QPointF::x() const

Renvoie la coordonnée x de ce point.

Voir aussi setX() et rx().

[constexpr noexcept] qreal QPointF::y() const

Renvoie la coordonnée y de ce point.

Voir aussi setY() et ry().

[constexpr] QPointF &QPointF::operator*=(qreal factor)

Multiplie les coordonnées de ce point par la valeur finie donnée factor, et renvoie une référence à ce point. Par exemple :

QPointF p(-1.1, 4.1);
p *= 2.5;    // p becomes (-2.75, 10.25)

Voir aussi operator/=().

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

Ajoute le site point à ce point et renvoie une référence à ce point. Par exemple :

QPointF p( 3.1, 7.1);
QPointF q(-1.0, 4.1);
p += q;    // p becomes (2.1, 11.2)

Voir aussi operator-=().

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

Soustrait la valeur point de ce point et renvoie une référence à ce point. Par exemple :

QPointF p( 3.1, 7.1);
QPointF q(-1.0, 4.1);
p -= q;    // p becomes (4.1, 3.0)

Voir aussi operator+=().

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

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

QPointF p(-2.75, 10.25);
p /= 2.5;           // p becomes (-1.1, 4.1)

L'adresse divisor ne doit pas être zéro ou NaN.

Voir également operator*=().

Non-membres apparentés

[constexpr noexcept, since 6.8] bool qFuzzyCompare(const QPointF &p1, const QPointF &p2)

Renvoie true si p1 est approximativement égal à p2; sinon, renvoie false.

Cette fonction a été introduite dans Qt 6.8.

Voir aussi qFuzzyIsNull.

[constexpr noexcept, since 6.8] bool qFuzzyIsNull(const QPointF &point)

Renvoie true si point est approximativement égal à un point (0.0, 0.0).

Cette fonction a été introduite dans Qt 6.8.

Voir aussi qFuzzyCompare.

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

Renvoie true si lhs est suffisamment différent de rhs; sinon renvoie false.

Attention : Cette fonction ne vérifie pas l'inégalité stricte ; elle utilise plutôt une comparaison floue pour comparer les coordonnées des points.

Voir également qFuzzyCompare.

[constexpr] QPointF operator*(const QPointF &point, qreal factor)

Renvoie une copie de l'adresse point donnée, multipliée par l'adresse finie factor donnée.

Voir aussi QPointF::operator*=().

[constexpr] QPointF operator*(qreal factor, const QPointF &point)

Renvoie une copie du fichier point, multiplié par le fichier fini factor.

Il s'agit d'une fonction surchargée.

[constexpr] QPointF operator+(const QPointF &point)

Retourne point non modifié.

[constexpr] QPointF operator+(const QPointF &p1, const QPointF &p2)

Renvoie un objet QPointF qui est la somme des points donnés, p1 et p2; chaque composante est ajoutée séparément.

Voir aussi QPointF::operator+=().

[constexpr] QPointF operator-(const QPointF &p1, const QPointF &p2)

Renvoie un objet QPointF formé en soustrayant p2 de p1; chaque composant est soustrait séparément.

Voir aussi QPointF::operator-=().

[constexpr] QPointF operator-(const QPointF &point)

Renvoie un objet QPointF formé en changeant le signe de chaque composante de l'objet point.

Équivalent à QPointF(0,0) - point.

Il s'agit d'une fonction surchargée.

[constexpr] QPointF operator/(const QPointF &point, qreal divisor)

Renvoie l'objet QPointF formé par la division de chaque composante de l'objet point par l'objet divisor.

L'adresse divisor ne doit pas être zéro ou NaN.

Voir aussi QPointF::operator/=().

QDataStream &operator<<(QDataStream &stream, const QPointF &point)

Écrit la donnée point dans la donnée stream et renvoie une référence au flux.

Voir aussi Serializing Qt Data Types (Sérialisation des types de données Qt).

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

Renvoie true si lhs est approximativement égal à rhs; sinon renvoie false.

Attention : Cette fonction ne vérifie pas l'égalité stricte ; elle utilise une comparaison floue pour comparer les coordonnées des points.

Voir également qFuzzyCompare.

QDataStream &operator>>(QDataStream &stream, QPointF &point)

Lit un point de l'adresse stream dans l'adresse point et renvoie une référence au flux.

Voir aussi Serializing Qt Data Types (Sérialisation des types de données Qt).

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