QLineF Class

Documentation des fonctions membres

[constexpr] QLineF::QLineF()

Construit une ligne nulle.

[constexpr] QLineF::QLineF(const QLine &line)

Construit un objet QLineF à partir de la base d'entiers donnée line.

Voir aussi toLine() et QLine::toLineF().

[constexpr] QLineF::QLineF(const QPointF &p1, const QPointF &p2)

Construit un objet ligne qui représente la ligne entre p1 et p2.

[constexpr] QLineF::QLineF(qreal x1, qreal y1, qreal x2, qreal y2)

Construit un objet ligne qui représente la ligne entre (x1, y1) et (x2, y2).

[constexpr] QPointF QLineF::p1() const

Renvoie le point de départ de la ligne.

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

[constexpr] QPointF QLineF::p2() const

Renvoie le point final de la ligne.

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

[constexpr] qreal QLineF::x1() const

Renvoie la coordonnée x du point de départ de la ligne.

Voir également p1().

[constexpr] qreal QLineF::x2() const

Renvoie la coordonnée x du point d'arrivée de la ligne.

Voir également p2().

[constexpr] qreal QLineF::y1() const

Renvoie la coordonnée y du point de départ de la ligne.

Voir également p1().

[constexpr] qreal QLineF::y2() const

Renvoie la coordonnée y du point d'arrivée de la ligne.

Voir également p2().

qreal QLineF::angle() const

Renvoie l'angle de la ligne en degrés.

La valeur renvoyée sera comprise entre 0,0 et 360,0. Les angles sont mesurés dans le sens inverse des aiguilles d'une montre à partir d'un point de l'axe des x à droite de l'origine (x > 0).

Voir également setAngle().

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

Renvoie l'angle (en degrés) entre cette ligne et l'adresse line, en tenant compte de la direction des lignes. Si les lignes ne sont pas intersect dans leur rayon d'action, c'est le point d'intersection des lignes prolongées qui sert d'origine (voir QLineF::UnboundedIntersection).

La valeur renvoyé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 line, dans le sens inverse des aiguilles d'une montre.

Voir également intersects().

[constexpr] QPointF QLineF::center() const

Renvoie le point central de cette ligne. Cela équivaut à 0,5 * p1() + 0,5 * p2().

[constexpr] qreal QLineF::dx() const

Renvoie la composante horizontale du vecteur de la ligne.

Voir aussi dy() et pointAt().

[constexpr] qreal QLineF::dy() const

Renvoie la composante verticale du vecteur de la ligne.

Voir aussi dx() et pointAt().

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

Renvoie une ligne QLineF avec les données length et angle.

Le premier point de la ligne sera sur l'origine.

Les valeurs positives des angles signifient le sens inverse des aiguilles d'une montre, tandis que les valeurs négatives signifient le sens des aiguilles d'une montre. Le zéro degré se trouve à la position 3 heures.

QLineF::IntersectionType QLineF::intersects(const QLineF &line, QPointF *intersectionPoint = nullptr) const

Renvoie une valeur indiquant si cette ligne coupe ou non la ligne donnée line.

Le point d'intersection réel est extrait vers intersectionPoint (si le pointeur est valide). Si les lignes sont parallèles, le point d'intersection est indéfini.

[constexpr] bool QLineF::isNull() const

Renvoie true si la ligne n'a pas de points de départ et d'arrivée distincts ; sinon, renvoie false. Les points de départ et d'arrivée sont considérés comme distincts si qFuzzyCompare() peut les distinguer dans au moins une coordonnée.

Voir également qFuzzyCompare() et length().

qreal QLineF::length() const

Renvoie la longueur de la ligne.

Voir aussi setLength() et isNull().

[constexpr] QLineF QLineF::normalVector() const

Renvoie une ligne perpendiculaire à cette ligne avec le même point de départ et la même longueur.

Voir aussi unitVector().

[constexpr] QPointF QLineF::pointAt(qreal t) const

Renvoie le point à la position spécifiée par le paramètre fini t. La fonction renvoie le point de départ de la ligne si t = 0, et son point d'arrivée si t = 1.

Voir également dx() et dy().

void QLineF::setP1(const QPointF &p1)

Fixe le point de départ de cette ligne à p1.

Voir aussi setP2() et p1().

void QLineF::setP2(const QPointF &p2)

Fixe le point final de cette ligne à p2.

Voir aussi setP1() et p2().

void QLineF::setAngle(qreal angle)

Définit l'angle de la ligne à l'adresse angle (en degrés). Cela modifiera la position du deuxième point de la ligne de manière à ce que la ligne ait l'angle donné.

Les valeurs positives des angles signifient le sens inverse des aiguilles d'une montre, tandis que les valeurs négatives signifient le sens des aiguilles d'une montre. L'angle zéro se situe à la position 3 heures.

Voir également angle().

void QLineF::setLength(qreal length)

Fixe la longueur de la ligne à la valeur finie donnée length. QLineF déplacera le point final - p2() - de la ligne pour lui donner sa nouvelle longueur, à moins que length() n'ait été précédemment égal à zéro, auquel cas aucune mise à l'échelle n'est tentée.

Voir également length() et unitVector().

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

Place cette ligne au début de x1, y1 et à la fin de x2, y2.

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

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

Définit le point de départ de cette ligne à p1 et le point d'arrivée de cette ligne à p2.

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

[constexpr] QLine QLineF::toLine() const

Renvoie une copie de cette ligne basée sur un nombre entier.

Notez que les points de départ et d'arrivée de la ligne retournée sont arrondis à l'entier le plus proche.

Voir aussi QLineF() et QLine::toLineF().

[constexpr] void QLineF::translate(const QPointF &offset)

Traduit cette ligne par la valeur donnée offset.

[constexpr] void QLineF::translate(qreal dx, qreal dy)

Traduit cette ligne à la distance spécifiée par dx et dy.

[constexpr] QLineF QLineF::translated(const QPointF &offset) const

Retourne cette ligne traduite par la valeur donnée offset.

[constexpr] QLineF QLineF::translated(qreal dx, qreal dy) const

Renvoie cette ligne traduite à la distance spécifiée par dx et dy.

QLineF QLineF::unitVector() const

Renvoie le vecteur unitaire de cette ligne, c'est-à-dire une ligne commençant au même point que cette ligne avec une longueur de 1,0, à condition que la ligne ne soit pas nulle.

Voir aussi normalVector() et setLength().