Sur cette page

QLine Class

La classe QLine fournit un vecteur bidimensionnel utilisant une précision entière. Plus d'informations...

En-tête : #include <QLine>
CMake : find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake : QT += core

Cette classe est comparable à l 'égalité.

Cette classe est comparable à QLineF.

Fonctions publiques

QLine()
QLine(const QPoint &p1, const QPoint &p2)
QLine(int x1, int y1, int x2, int y2)
QPoint p1() const
QPoint p2() const
int x1() const
int x2() const
int y1() const
int y2() const
QPoint center() const
int dx() const
int dy() const
bool isNull() const
void setP1(const QPoint &p1)
void setP2(const QPoint &p2)
void setLine(int x1, int y1, int x2, int y2)
void setPoints(const QPoint &p1, const QPoint &p2)
(since 6.4) QLineF toLineF() const
void translate(const QPoint &offset)
void translate(int dx, int dy)
QLine translated(const QPoint &offset) const
QLine translated(int dx, int dy) const
bool operator!=(const QLine &lhs, const QLine &rhs)
QDataStream &operator<<(QDataStream &stream, const QLine &line)
bool operator==(const QLine &lhs, const QLine &rhs)
QDataStream &operator>>(QDataStream &stream, QLine &line)

Description détaillée

Une QLine décrit une ligne de longueur finie (ou un segment de ligne) sur une surface bidimensionnelle. Les points de départ et d'arrivée de la ligne sont spécifiés à l'aide d'une précision de point entier pour les coordonnées. Le constructeur QLineF permet de récupérer une copie en virgule flottante.

Les positions des points de départ et d'arrivée de la ligne peuvent être récupérées à l'aide des fonctions p1(), x1(), y1(), p2(), x2() et y2(). Les fonctions dx() et dy() renvoient les composantes horizontale et verticale de la ligne. Utilisez isNull() pour déterminer si la QLine représente une ligne valide ou une ligne nulle.

Enfin, la ligne peut être translatée d'un décalage donné à l'aide de la fonction translate().

Voir également QLineF, QPolygon, et QRect.

Documentation des fonctions membres

[constexpr] QLine::QLine()

Construit une ligne nulle.

[constexpr] QLine::QLine(const QPoint &p1, const QPoint &p2)

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

[constexpr] QLine::QLine(int x1, int y1, int x2, int y2)

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

[constexpr] QPoint QLine::p1() const

Renvoie le point de départ de la ligne.

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

[constexpr] QPoint QLine::p2() const

Renvoie le point final de la ligne.

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

[constexpr] int QLine::x1() const

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

Voir également p1().

[constexpr] int QLine::x2() const

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

Voir également p2().

[constexpr] int QLine::y1() const

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

Voir également p1().

[constexpr] int QLine::y2() const

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

Voir également p2().

[constexpr] QPoint QLine::center() const

Renvoie le point central de cette ligne. Ceci est équivalent à (p1() + p2()) / 2, sauf qu'il ne débordera jamais.

[constexpr] int QLine::dx() const

Renvoie la composante horizontale du vecteur de la ligne.

Voir aussi dy().

[constexpr] int QLine::dy() const

Renvoie la composante verticale du vecteur de la ligne.

Voir aussi dx().

[constexpr] bool QLine::isNull() const

Renvoie true si la ligne n'a pas de points de départ et d'arrivée distincts ; sinon, renvoie false.

void QLine::setP1(const QPoint &p1)

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

Voir aussi setP2() et p1().

void QLine::setP2(const QPoint &p2)

Fixe le point final de cette ligne à p2.

Voir aussi setP1() et p2().

void QLine::setLine(int x1, int y1, int x2, int y2)

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

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

void QLine::setPoints(const QPoint &p1, const QPoint &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 noexcept, since 6.4] QLineF QLine::toLineF() const

Renvoie cette ligne en tant que ligne avec une précision en virgule flottante.

Cette fonction a été introduite dans Qt 6.4.

Voir aussi QLineF::toLine().

[constexpr] void QLine::translate(const QPoint &offset)

Traduit cette ligne par la valeur donnée offset.

[constexpr] void QLine::translate(int dx, int dy)

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

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

[constexpr] QLine QLine::translated(const QPoint &offset) const

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

[constexpr] QLine QLine::translated(int dx, int dy) const

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

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

Non-membres apparentés

[constexpr noexcept] bool operator!=(const QLine &lhs, const QLine &rhs)

Renvoie true si la ligne lhs n'est pas la même que la ligne rhs.

Une ligne est différente d'une autre ligne si l'un de ses points de départ ou d'arrivée diffère, ou si l'ordre interne des points est différent.

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

Écrit la donnée line dans la donnée stream et renvoie une référence au flux.

Voir aussi Serializing Qt Data Types (Sérialisation des types de données Qt).

[constexpr noexcept] bool operator==(const QLine &lhs, const QLine &rhs)

Renvoie true si la ligne lhs est identique à la ligne rhs.

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

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

Lit une ligne de l'adresse stream donnée dans l'adresse line donnée et renvoie une référence au flux.

Voir aussi Serializing Qt Data Types (Sérialisation des types de données Qt).

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.