===== QPointF =====

La classe QPointF définit un point dans le plan utilisant des coordonnées décimales. [[#Description détaillée|Plus d'informations...]]

<!inc!>

==== 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 :

<code cpp-qt>QPointF p;
 
p.setX(p.x() + 1);
p += QPoint(1, 0);
p.rx()++;</code>

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::QPointF ()''

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

Voir aussi [[#isNull()]].

=== QPointF() ===

''QPointF::QPointF ( const [[QPoint]] & point )''

Construit une copie du ''point'' donné.

Voir aussi [[#toPoint()]].

=== QPointF() ===

''QPointF::QPointF ( [[qtglobal#qreal-typedef|qreal]] x, [[qtglobal#qreal-typedef|qreal]] y )''

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

Voir aussi [[#setX()]] et [[#setY()]].

=== isNull() ===

''bool QPointF::isNull () const''

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

=== manhattanLength() ===

''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|QPoint::manhattanLength()]].
=== rx() ===

''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 :

<code cpp-qt>QPointF p(1.1, 2.5);
p.rx()--;   // p prend la valeur (0.1, 2.5)</code>

Voir aussi [[#x()]] et [[#setX()]].
=== ry() ===

''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 :

<code cpp-qt>QPointF p(1.1, 2.5);
p.ry()++;   // p prend la valeur (1.1, 3.5)</code>

Voir aussi [[#y()]] et [[#setY()]].

=== setX() ===

''void QPointF::setX ( [[qtglobal#qreal-typedef|qreal]] x )''

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

Voir aussi [[#x()]] et [[#setY()]].
=== setY() ===

''void QPointF::setY ( [[qtglobal#qreal-typedef|qreal]] y )''

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

Voir aussi [[#y()]] et [[#setX()]].

=== toPoint() ===

''[[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()]].

=== x() ===

''int QPointF::x () const''

Retourne la coordonnée x du point.

Voir aussi [[#setX()]] et [[#rx()]].

=== y() ===

''int QPointF::y () const''

Retourne la coordonnée y du point.

Voir aussi [[#setY()]] et [[#ry()]].
=== operator*=() ===

''QPointF & QPointF::operator*= ( [[qtglobal#qreal-typedef|qreal]] factor )''

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

<code cpp-qt>QPointF p(-1.1, 4.1);
p *= 2.5;    // p prend la valeur (-2.75, 10.25)</code>

Voir aussi [[#operator/=()]].
=== 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 :

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

Voir aussi [[#operator-=()]].
=== 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 :

<code cpp-qt>QPointF p( 3.1, 7.1);
QPointF q(-1.0, 4.1);
p -= q;    // p prend la valeur (4.1, 3.0)</code>

Voir aussi [[#operator+=()]].

=== operator/=() ===

''QPointF & QPointF::operator/= ( [[qtglobal#qreal-typedef|qreal]] divisor )''

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

<code cpp-qt>QPointF p(-2.75, 10.25);
p /= 2.5;    // p prend la valeur (-1.1, 4.1)</code>

Voir aussi [[#operator*=()]].

==== En relation mais non membres de la classe ====

=== operator!=() ===

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

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

=== operator*() ===

''const QPointF operator* ( const QPointF & point, [[qtglobal#qreal-typedef|qreal]] factor )''

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

Voir aussi [[#operator*=|QPointF::operator*=()]].

=== operator*() ===

''const QPointF operator* ( [[qtglobal#qreal-typedef|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é.

=== operator+() ===

''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 [[#operator+=|QPointF::operator+=()]].

=== 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 [[#operator-=|QPointF::operator-=()]].

=== 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''.

=== operator/() ===

''const QPointF operator/ ( const QPointF & point, [[qtglobal#qreal-typedef|qreal]] divisor )''

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

Voir aussi [[#operator/=|QPointF::operator/=()]].

=== 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 [[datastreamformat|Format des opérateurs de QDataStream]].
=== operator==() ===
 
''bool operator== ( const QPointF & p1, const QPointF & p2 )''
 
Retourne ''true'' si ''p1'' et ''p2'' sont égaux ; sinon retourne ''false''.

=== operator>>() ===

''[[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 [[datastreamformat|Format des opérateurs de QDataStream]].

==== Remerciements ====

Merci à <!abdelite!> pour la traduction et à <!johnlamericain!> ainsi qu'à <!hornetbzz!> pour leur relecture !