QPointF Class
La classe `QPointF` définit un point dans le plan en utilisant la précision en virgule flottante. En savoir plus...
| En-tête : | #include <QPointF> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake : | QT += core |
- Liste de tous les membres, y compris les membres hérités
- QPointF fait partie des classes de peinture.
Remarque : toutes les fonctions de cette classe sont réentrantes.
Comparaisons de QPointF
| Catégorie | Types comparables |
|---|---|
| égalité | QPointF |
| égalité | QPoint. |
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) |
Éléments non membres associés
(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 à l'aide de nombres à virgule flottante finis pour garantir la précision. La fonction isNull() renvoie true si x et y sont tous deux définis à 0,0. Les coordonnées peuvent être définies (ou modifiées) à l’aide des fonctions setX() et setY(), ou bien à l’aide des fonctions rx() et ry(), qui renvoient des références aux coordonnées (permettant ainsi une manipulation directe).
Pour un point p donné, les instructions suivantes sont toutes équivalentes :
Un objet `QPointF` peut également être utilisé comme un vecteur : l’addition et la soustraction sont définies comme pour les vecteurs (chaque composante est additionnée séparément). Un objet `QPointF` peut également être divisé ou multiplié par un ` int ` ou un ` qreal`.
De plus, la classe QPointF fournit un constructeur convertissant un objet ` QPoint ` en un objet `QPointF`, ainsi qu’une fonction correspondante ` toPoint()` qui renvoie une copie ` QPoint ` de ce point. Enfin, les objets `QPointF` peuvent être transmis via un flux et comparés.
Voir aussi QPoint et QPolygonF.
Documentation des fonctions membres
[constexpr noexcept] QPointF::QPointF()
Crée un point nul, c'est-à-dire de coordonnées (0,0 ; 0,0)
Voir également isNull().
[constexpr noexcept] QPointF::QPointF(const QPoint &point)
Crée une copie de l'point.
Voir également toPoint() et QPoint::toPointF().
[constexpr noexcept] QPointF::QPointF(qreal xpos, qreal ypos)
Crée un point aux coordonnées indiqué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.01Renvoie le produit scalaire de p1 et p2.
[static noexcept] QPointF QPointF::fromCGPoint(CGPoint point)
Crée un objet « QRectF » à partir de « CGPoint » point.
Voir aussi toCGPoint().
[noexcept] bool QPointF::isNull() const
Renvoie « true » si les coordonnées x et y sont toutes deux égales à 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 appelée « longueur de Manhattan » du vecteur reliant 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)[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 la coordonnée y. Par exemple :
QPointF p(1.1, 2.5);
p.ry()++; // p becomes (1.1, 3.5)[constexpr noexcept] void QPointF::setX(qreal x)
Définit la coordonnée x de ce point sur la coordonnée finie donnée x.
[constexpr noexcept] void QPointF::setY(qreal y)
Définit la coordonnée y de ce point sur la coordonnée donnée de l'y.
[noexcept] CGPoint QPointF::toCGPoint() const
Crée un objet `CGPoint` à partir d'un objet ` QPointF`.
Voir également fromCGPoint().
[constexpr] QPoint QPointF::toPoint() const
Arrondit les coordonnées de ce point à l'entier le plus proche et renvoie un objet ` QPoint ` contenant les coordonnées arrondies.
Voir également QPointF() et QPoint::toPointF().
[constexpr noexcept] QPointF QPointF::transposed() const
Renvoie un point dont les coordonnées x et y sont inversées :
QPointF{1.0, 2.0}.transposed() // {2.0, 1.0}Voir également x(), y(), setX() et setY().
[constexpr noexcept] qreal QPointF::x() const
Renvoie la coordonnée x de ce point.
Voir également setX() et rx().
[constexpr noexcept] qreal QPointF::y() const
Renvoie la coordonnée y de ce point.
Voir également setY() et ry().
[constexpr] QPointF &QPointF::operator*=(qreal factor)
Multiplie les coordonnées de ce point par l'factor finie donnée 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 l'point on indiquée à ce point et renvoie une référence à ce point. Par exemple :
Voir aussi operator-=().
[constexpr] QPointF &QPointF::operator-=(const QPointF &point)
Soustrait l'point on indiquée de ce point et renvoie une référence à ce point. Par exemple :
Voir aussi ` operator+=()`.
[constexpr] QPointF &QPointF::operator/=(qreal divisor)
Divise à la fois x et y par l’ divisor donnée, puis 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'divisor ne doit pas être égal à zéro ni à NaN.
Voir aussi operator*=().
Éléments non membres associé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 également 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 également qFuzzyCompare.
[constexpr noexcept] bool operator!=(const QPointF &lhs, const QPointF &rhs)
Renvoie « true » si « lhs » est suffisamment différent de « rhs » ; sinon, renvoie « false ».
Avertissement : cette fonction ne vérifie pas s'il existe une inégalité stricte ; elle utilise plutôt une comparaison approximative pour comparer les coordonnées des points.
Voir également qFuzzyCompare.
[constexpr] QPointF operator*(const QPointF &point, qreal factor)
Renvoie une copie de l'point donné, multipliée par l'factor fini donné.
Voir aussi QPointF::operator*=().
[constexpr] QPointF operator*(qreal factor, const QPointF &point)
Renvoie une copie de l'point donné, multipliée par l'factor fini donné.
Il s'agit d'une fonction surchargée.
[constexpr] QPointF operator+(const QPointF &point)
Renvoie « point » sans modification.
[constexpr] QPointF operator+(const QPointF &p1, const QPointF &p2)
Renvoie un objet de type « QPointF » correspondant à la somme des points indiqués : p1 et p2; chaque composante est additionnée séparément.
Voir aussi QPointF::operator+=().
[constexpr] QPointF operator-(const QPointF &p1, const QPointF &p2)
Renvoie un objet ` QPointF ` obtenu en soustrayant ` p2 ` de ` p1` ; chaque composante est soustraite séparément.
Voir également QPointF::operator-=().
[constexpr] QPointF operator-(const QPointF &point)
Renvoie un objet ` QPointF ` obtenu en inversant le signe de chaque composante de la valeur ` point` fournie.
É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 ` obtenu en divisant chaque composante de l'point donné par l'divisor donné.
La valeur divisor ne doit pas être égale à zéro ni à NaN.
Voir également QPointF::operator/=().
QDataStream &operator<<(QDataStream &stream, const QPointF &point)
Écrit l'point on fournie dans le stream on indiquée et renvoie une référence au flux.
Voir également 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 ».
Avertissement : cette fonction ne vérifie pas l'égalité stricte ; elle utilise plutôt une comparaison approximative pour comparer les coordonnées des points.
Voir également qFuzzyCompare.
QDataStream &operator>>(QDataStream &stream, QPointF &point)
Lit un point à partir de l'stream donné dans l'point donné et renvoie une référence au flux.
Voir aussi 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.