QPointF

La classe QPointF définit un point dans le plan utilisant des coordonnées décimales. Plus d'informations...

#include <QPointF>

Voir la position dans l'arbre des classes.

Description détaillée

La classe QPointF définit un point dans le plan utilisant des coordonnées décimales.

Un point possède, une coordonnée x et une coordonnée y qui peuvent être récupérées en utilisant les fonctions x() et y(). La fonction isNull() retourne true si à la fois x et y valent 0.0. Les coordonnées peuvent être définies (ou modifiées) en utilisant les fonctions setX() et setY(), ou alternativement par les fonctions rx() et ry() qui retournent des références vers les coordonnées (permettant des manipulations directes).

Soit un point p donné. Les déclarations qui suivent sont toutes équivalentes :

QPointF p;
 
p.setX(p.x() + 1);
p += QPoint(1, 0);
p.rx()++;

Un objet QPointF peut également être utilisé comme un vecteur : les additions et les soustractions sont définies comme des vecteurs (chaque composante est ajoutée séparément). Un objet QPointF peut également être multiplié ou divisé par un int ou un qreal.

De plus, la classe QPointF fournit un constructeur de conversion d'un objet QPoint en un objet QPointF, et une fonction toPoint() correspondante qui retourne une copie QPoint de ce point. Enfin, des objets QPointF peuvent : soit être insérés dans un flux, soit être comparés entre eux.

Voir aussi QPoint et QPolygonF.

Fonctions membres

QPointF::QPointF ()

Construit un point nul, c'est-à-dire un point de coordonnées (0.0, 0.0).

Voir aussi isNull().

QPointF::QPointF ( const QPoint & point )

Construit une copie du point donné.

Voir aussi toPoint().

QPointF::QPointF ( qreal x, qreal y )

Construit un point avec les coordonnées (x, y) données.

Voir aussi setX() et setY().

bool QPointF::isNull () const

Retourne true si les coordonnées x et y valent toutes les deux 0.0, sinon retourne false.

int QPointF::manhattanLength () const

Retourne la somme des valeurs absolues de x() et de y(), traditionnellement connue en tant que la « longueur de Manhattan » du vecteur, de l'origine jusqu'au point.

Cette fonction a été introduite dans Qt 4.6.

Voir aussi QPoint::manhattanLength().

int & QPointF::rx ()

Retourne une référence vers la coordonnée x du point.

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

QPointF p(1.1, 2.5);
p.rx()--;   // p prend la valeur (0.1, 2.5)

Voir aussi x() et setX().

int & QPointF::ry ()

Retourne une référence vers la coordonnée y du point.

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

QPointF p(1.1, 2.5);
p.ry()++;   // p prend la valeur (1.1, 3.5)

Voir aussi y() et setY().

void QPointF::setX ( qreal x )

Définit la coordonnée x du point avec la coordonnée x donnée.

Voir aussi x() et setY().

void QPointF::setY ( qreal y )

Définit la coordonnée y du point avec la coordonnée y donnée.

Voir aussi y() et setX().

QPoint QPointF::toPoint () const

Arrondit les coordonnées du point aux entiers les plus proche, et retourne un objet QPoint avec les arrondis des coordonnées.

Voir aussi QPointF().

int QPointF::x () const

Retourne la coordonnée x du point.

Voir aussi setX() et rx().

int QPointF::y () const

Retourne la coordonnée y du point.

Voir aussi setY() et ry().

QPointF & QPointF::operator*= ( qreal factor )

Multiplie les coordonnées du point avec le facteur factor donné, et retourne une référence vers ce point. Par exemple :

QPointF p(-1.1, 4.1);
p *= 2.5;    // p prend la valeur (-2.75, 10.25)

Voir aussi operator/=().

QPointF & QPointF::operator+= ( const QPointF & point )

Ajoute le point donné au point instancié et retourne une référence vers ce point. Par exemple :

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

Voir aussi operator-=().

QPointF & QPointF::operator-= ( const QPointF & point )

Soustrait le point donné au point instancié et retourne une référence vers ce point. Par exemple :

QPointF p( 3.1, 7.1);
QPointF q(-1.0, 4.1);
p -= q;    // p prend la valeur (4.1, 3.0)

Voir aussi operator+=().

QPointF & QPointF::operator/= ( qreal divisor )

Divise x et y par le diviseur divisor donné, et retourne une référence vers ce point. Par exemple :

QPointF p(-2.75, 10.25);
p /= 2.5;    // p prend la valeur (-1.1, 4.1)

Voir aussi operator*=().

En relation mais non membres de la classe

bool operator!= ( const QPointF & p1, const QPointF & p2 )

Retourne true si p1 et p2 ne sont pas égaux, sinon retourne false.

const QPointF operator* ( const QPointF & point, qreal factor )

Retourne une copie du point donné, multipliée par le facteur factor donné.

Voir aussi QPointF::operator*=().

const QPointF operator* ( qreal factor, const QPointF & point )

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

Retourne une copie du point point donné, multipliée par le facteur factor donné.

const QPointF operator+ ( const QPointF & p1, const QPointF & p2 )

Retourne un objet de QPointF qui correspond à la somme des points fournis, p1 et p2 ; chaque composante est ajoutée séparément.

Voir aussi QPointF::operator+=().

const QPointF operator- ( const QPointF & p1, const QPointF & p2 )

Retourne un objet QPointF qui est le résultat de la soustraction p1 moins p2 ; chaque composante est ajoutée séparément.

Voir aussi QPointF::operator-=().

const QPointF operator- ( const QPointF & point )

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

Retourne un objet de QPointF qui est formé par le changement de signe des deux composantes du point donné.

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

const QPointF operator/ ( const QPointF & point, qreal divisor )

Retourne le QPointF formé par la division des deux composantes du point par le diviseur divisor donné.

Voir aussi QPointF::operator/=().

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

Écrit le point donné dans le flux stream donné et retourne une référence vers ce flux.

Voir aussi sérialisation des type de données Qt.

bool operator== ( const QPointF & p1, const QPointF & p2 )

Retourne true si p1 et p2 sont égaux ; sinon retourne false.

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

Lit un point depuis le flux stream vers le point donné point et retourne une référence vers ce flux.

Voir aussi sérialisation des type de données Qt.

Remerciements

Merci à Abdelhafid Hafidi pour la traduction et à Jonathan Courtois ainsi qu'à Philippe Beaucart pour leur relecture !