QLineF

La classe QLineF propose un vecteur � deux dimensions utilisant une pr�cision d�cimale. Plus d'informations...

#include <QLineF>

Voir la position dans l'arbre des classes.

Description d�taill�e

La classe QLineF propose un vecteur � deux dimensions utilisant une pr�cision d�cimale.

Une QLineF d�crit une ligne de longueur finie (un segment de droite) sur une surface � deux dimensions. QLineF d�finit les points de d�part et d'arriv�e de la ligne en utilisant une pr�cision d�cimale pour les coordonn�es des points. Utilisez la fonction toLine() pour r�cup�rer une copie de la ligne en nombre entier.

Les positions des points de d�part et d'arriv�e de la ligne peuvent �tre retrouv�es avec les fonctions p1(), x1(), y1(), p2(), x2() et y2(). Les fonctions dx() et dy() retournent les composantes horizontales et verticales de la ligne, respectivement.

La longueur de la ligne peut �tre retrouv�e en utilisant la fonction length() et modifi�e en utilisant la fonction setLength(). De fa�on similaire, angle() et setAngle() sont respectivement utilis�es pour r�cup�rer et modifier l'angle de la ligne. Utilisez isNull() pour d�terminer si QLineF repr�sente une ligne valide ou nulle.

La fonction intersect() d�termine le type IntersectType pour cette ligne et une ligne donn�e, tandis que la fonction angle() retourne l'angle entre les lignes. De plus, la fonction unitVector() retourne une ligne qui a le m�me point de d�part que cette ligne mais avec une longueur de 1, tandis que la fonction normalVector() retourne une ligne qui est perpendiculaire � cette ligne avec le m�me point de d�part et la m�me longueur.

Finalement, la ligne peut �tre translat�e en utilisant la fonction translate() et peut �tre parcourue en utilisant la fonction pointAt().

Voir aussi QLine, QPolygonF et QRectF.

Types

enum QLineF::IntersectType

D�crit l'intersection entre deux lignes.

QLineF::UnboundedIntersection	QLineF::BoundedIntersection

intersect() retournera �galement cette valeur si le point d'intersection est le point de d�part ou d'arriv�e de seulement une des lignes.

Voir aussi intersect().

Fonctions membres

QLineF::QLineF ()

Construit une ligne nulle.

QLineF::QLineF ( const QPointF & p1, const QPointF & p2 )

Construit un objet ligne qui repr�sente la ligne entre les points p1 et p2.

QLineF::QLineF ( qreal x1, qreal y1, qreal x2, qreal y2 )

Construit un objet ligne qui repr�sente la ligne entre les points de coordonn�es (x1, y1) et (x2, y2).

QLineF::QLineF ( const QLine & line )

Construit un objet QLineF � partir d'une ligne en pr�cision enti�re line donn�e.

Voir aussi toLine().

QPointF QLineF::p1 () const

Retourne le point de d�part de la ligne.

Voir aussi setP1(), x1(), y1() et p2().

QPointF QLineF::p2 () const

Retourne le point d'arriv�e de la ligne.

Voir aussi setP2(), x2(), y2() et p1().

qreal QLineF::x1 () const

Retourne la coordonn�e x du point de d�part de la ligne.

Voir aussi p1().

qreal QLineF::x2 () const

Retourne la coordonn�e x du point d'arriv�e de la ligne.

Voir aussi p2().

qreal QLineF::y1 () const

Retourne la coordonn�e y du point de d�part de la ligne.

Voir aussi p1().

qreal QLineF::y2 () const

Retourne la coordonn�e y du point d'arriv�e de la ligne.

Voir aussi p2().

qreal QLineF::angle () const

Retourne l'angle de la ligne en degr�s.

Les valeurs positives pour les angles signifient le sens anti-horaire tandis que les valeurs n�gatives signifient le sens horaire. Z�ro degr� est � la position 3 heures.

Cette fonction a �t� introduite dans Qt 4.4.

Voir aussi setAngle().

qreal QLineF::angleTo ( const QLineF & line ) const

Retourne l'angle (en degr�s) de cette ligne � la ligne donn�e, prenant en compte la direction des lignes. Si les lignes ne se croisent pas dans cette plage, c'est le point d'intersection des lignes �tendues qui sert d'origine (voir QLineF::UnboundedIntersection).

La valeur retourn�e repr�sente le nombre de degr�s que vous devez ajouter � cette ligne pour qu'elle ait le m�me angle que la ligne donn�e, en allant dans le sens anti-horaire.

Cette fonction a �t� introduite dans Qt 4.4.

Voir aussi intersect().

qreal QLineF::dx () const

Retourne la composante horizontale (x) du vecteur de la ligne.

Voir aussi dy() et pointAt().

qreal QLineF::dy () const

Retourne la composante verticale (y) du vecteur de la ligne.

Voir aussi dx() et pointAt().

QLineF QLineF::fromPolar ( qreal length, qreal angle ) [static]

Retourne une QLineF avec la longueur length et l'angle angle donn�s.

Le premier point de cette ligne sera � l'origine.

Les valeurs positives pour les angles signifient le sens anti-horaire tandis que les valeurs n�gatives signifient le sens horaire. Z�ro degr� est � la position 3 heures.

Cette fonction a �t� introduite dans Qt 4.4.

IntersectType QLineF::intersect ( const QLineF & line, QPointF * intersectionPoint ) const

Retourne une valeur indiquant si oui ou non, cette ligne croise la ligne line donn�e.

Le point d'intersection actuel est plac� dans intersectionPoint (si le pointeur est valide). Si les lignes sont parall�les, le point d'intersection est ind�fini.

bool QLineF::isNull () const

Retourne true si la ligne n'est pas d�finie avec un point de d�part et d'arriv�e valide ; sinon retourne false.

qreal QLineF::length () const

Retourne la longueur de la ligne.

Voir aussi setLength().

QLineF QLineF::normalVector () const

Retourne une ligne qui est perpendiculaire � cette ligne avec le m�me point de d�part et la m�me longueur.

Voir aussi unitVector().

QPointF QLineF::pointAt ( qreal t ) const

Retourne le point � la position param�tr�e indiqu�e par t. La fonction retourne le point de d�part de la ligne si t = 0 et le point d'arriv�e si t = 1.

Voir aussi dx() et dy().

void QLineF::setP1 ( const QPointF & p1 )

D�finit le point de d�part de cette ligne comme �tant p1.

Cette fonction a �t� introduite dans Qt 4.4.

Voir aussi setP2() et [[#p1().

void QLineF::setP2 ( const QPointF & p2 )

D�finit le point d'arriv�e de cette ligne comme �tant p2.

Cette fonction a �t� introduite dans Qt 4.4.

Voir aussi setP1() et p2().

void QLineF::setAngle ( qreal angle )

D�finit l'angle de la ligne avec l'angle angle donn� (en degr�s). La position du second point sera chang�e pour que la ligne obtienne l'angle voulu.

Les valeurs positives pour les angles signifient le sens anti-horaire tandis que les valeurs n�gatives signifient le sens horaire. Z�ro degr� est � la position 3 heures.

Cette fonction a �t� introduite dans Qt 4.4.

Voir aussi angle().

void QLineF::setLength ( qreal length )

D�finit la longueur de la ligne � length. QLineF d�placera le point d'arriv�e (p2()) pour donner � la ligne sa nouvelle longueur.

Si la ligne est une ligne nulle, la longueur restera nulle quelle que soit la longueur sp�cifi�e.

Voir aussi length() et isNull().

void QLineF::setLine ( qreal x1, qreal y1, qreal x2, qreal y2 )

D�finit cette ligne avec, comme d�part, le point de coordonn�ess (x1 ; y1) et, comme arriv�e, le point de coordonn�ess (x2 ; y2).

Cette fonction a �t� introduite dans Qt 4.4.

Voir aussi setP1(), setP2(), p1() et p2().

void QLineF::setPoints ( const QPointF & p1, const QPointF & p2 )

D�fini le point de d�part de cette ligne � p1 et le point d'arriv� � p2.

Cette fonction a �t� introduite dans Qt 4.4.

Voir aussi setP1(), setP2(), p1() et p2().

QLine QLineF::toLine () const

Retourne une copie de la ligne en nombre entier.

Notez que la ligne enti�re retourn�e voit les coordonn�es de ses points de d�part et d'arriv�e arrondies � l'entier le plus proche.

Voir aussi QLineF().

void QLineF::translate ( const QPointF & offset )

Translate cette ligne avec le d�calage offset donn�.

void QLineF::translate ( qreal dx, qreal dy )

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

Translate cette ligne avec la distance sp�cifi�e par dx et dy.

QLineF QLineF::translated ( const QPointF & offset ) const

Retourne la ligne translat�e par le d�calage offset donn�.

Cette fonction a �t� introduite dans Qt 4.4.

QLineF QLineF::translated ( qreal dx, qreal dy ) const

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

Retourne la ligne translat�e par la distance sp�cifi�e par dx et dy.

Cette fonction a �t� introduite dans Qt 4.4.

QLineF QLineF::unitVector () const

Retourne le vecteur unitaire pour cette ligne, c'est-�-dire une ligne commen�ant au m�me point de d�part que cette ligne mais avec une longueur de 1.0.

Voir aussi normalVector().

bool QLineF::operator!= ( const QLineF & line ) const

Retourne true si la ligne line donn�e n'est pas la m�me que cette ligne.

Une ligne est diff�rente d'une autre si, soit son point de d�part, soit son point d'arriv�e est diff�rent ou si l'ordre interne des points est diff�rent.

bool QLineF::operator== ( const QLineF & line ) const

Retourne true si la ligne line donn�e est la m�me que cette ligne.

Une ligne est identique � une autre si les points de d�part et d'arriv�e sont identiques et si l'ordre interne des points est le m�me.

En relation mais non membres de la classe

QDataStream & operator<< ( QDataStream & stream, const QLineF & line )

�crit la ligne line donn�e dans le flux stream donn� et retourne une r�f�rence sur le flux.

Voir aussi s�rialisation des types de donn�es Qt.

QDataStream & operator>> ( QDataStream & stream, QLineF & line )

Lit une ligne � partir du flux stream donn�, la place dans la ligne line donn�e et retourne une r�f�rence sur le flux.

Voir aussi s�rialisation des types de donn�es Qt.

Remerciements

Merci � Abdelhafid Hafidi pour la traduction, � Jonathan Courtois pour la traduction et la relecture ainsi qu'� Thibaut Cuvelier et Maxime Gault pour la relecture !