QLine Class
La classe QLine fournit un vecteur bidimensionnel à précision entière. En savoir plus…
| En-tête : | #include <QLine> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake : | QT += core |
- Liste de tous les membres, y compris les membres hérités
- QLine fait partie des classes de peinture.
Comparaisons de QLine
| Catégorie | Types comparables |
|---|---|
| égalité | QLine |
| égalité | 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 |
Éléments non membres associés
| 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
Un objet QLine décrit une ligne de longueur finie (ou un segment de droite) sur une surface bidimensionnelle. Les points de départ et d’arrivée de la ligne sont spécifiés à l’aide de coordonnées à précision entière. Utilisez le constructeur QLineF pour obtenir 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 respectivement 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 décalée d’une distance donnée à l’aide de la fonction translate().
Voir également QLineF, QPolygon et QRect.
Documentation des fonctions membres
[constexpr] QLine::QLine()
Crée une droite nulle.
[constexpr] QLine::QLine(const QPoint &p1, const QPoint &p2)
Crée un objet « ligne » représentant la ligne reliant p1 et p2.
[constexpr] QLine::QLine(int x1, int y1, int x2, int y2)
Crée un objet « ligne » représentant la ligne reliant les points (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 également setP2(), x2(), y2() et p1().
[constexpr] int QLine::x1() const
Renvoie la coordonnée x du point de départ de la ligne.
Voir aussi p1().
[constexpr] int QLine::x2() const
Renvoie la coordonnée x du point d'extrémité de la ligne.
Voir aussi p2().
[constexpr] int QLine::y1() const
Renvoie la coordonnée y du point de départ de la ligne.
Voir aussi p1().
[constexpr] int QLine::y2() const
Renvoie la coordonnée y du point d'extrémité de la ligne.
Voir aussi p2().
[constexpr] QPoint QLine::center() const
Renvoie le point central de cette ligne. Cela équivaut à (p1()) + p2()) / 2, sauf que cela ne provoquera jamais de débordement.
[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 ne comporte pas de points de départ et d'arrivée distincts ; sinon, renvoie « false ».
void QLine::setP1(const QPoint &p1)
Définit le point de départ de cette ligne sur p1.
Voir également setP2() et p1().
void QLine::setP2(const QPoint &p2)
Définit le point d'arrivée de cette ligne sur p2.
Voir également setP1() et p2().
void QLine::setLine(int x1, int y1, int x2, int y2)
Définit cette ligne comme point de départ dans x1, y1 et comme point d'arrivée dans x2, y2.
Voir également 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 son point d'arrivée à p2.
Voir également setP1(), setP2(), p1() et p2().
[constexpr noexcept, since 6.4] QLineF QLine::toLineF() const
Renvoie cette ligne sous forme de ligne avec une précision en virgule flottante.
Cette fonction a été introduite dans Qt 6.4.
Voir également QLineF::toLine().
[constexpr] void QLine::translate(const QPoint &offset)
Traduit cette ligne selon l'offset ion indiquée.
[constexpr] void QLine::translate(int dx, int dy)
Déplace cette ligne de 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
Renvoie cette ligne traduite par l'offset on indiquée.
[constexpr] QLine QLine::translated(int dx, int dy) const
Renvoie cette ligne décalée de la distance spécifiée par dx et dy.
Il s'agit d'une fonction surchargée.
Éléments non membres associés
[constexpr noexcept] bool operator!=(const QLine &lhs, const QLine &rhs)
Renvoie « true » si la ligne lhs n'est pas identique à la ligne rhs.
Deux lignes sont différentes si l'un de leurs 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 l'line on fournie dans le flux stream spécifié et renvoie une référence à ce flux.
Voir également 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 si ses 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 à partir du fichier stream spécifié et l'écrit dans le fichier line spécifié, puis renvoie une référence au flux.
Voir également 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.
