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 !