Sur cette page

QGraphicsLineItem Class

La classe `QGraphicsLineItem` permet de créer un élément de ligne que vous pouvez ajouter à un ` QGraphicsScene`. En savoir plus...

En-tête : #include <QGraphicsLineItem>
CMake : find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake : QT += widgets
Hérite de : QGraphicsItem

Types publics

enum { Type }

Fonctions publiques

QGraphicsLineItem(QGraphicsItem *parent = nullptr)
QGraphicsLineItem(const QLineF &line, QGraphicsItem *parent = nullptr)
QGraphicsLineItem(qreal x1, qreal y1, qreal x2, qreal y2, QGraphicsItem *parent = nullptr)
virtual ~QGraphicsLineItem()
QLineF line() const
QPen pen() const
void setLine(const QLineF &line)
void setLine(qreal x1, qreal y1, qreal x2, qreal y2)
void setPen(const QPen &pen)

Fonctions publiques réimplémentées

virtual QRectF boundingRect() const override
virtual bool contains(const QPointF &point) const override
virtual bool isObscuredBy(const QGraphicsItem *item) const override
virtual QPainterPath opaqueArea() const override
virtual void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr) override
virtual QPainterPath shape() const override
virtual int type() const override

Description détaillée

Pour définir la ligne de l'élément, passez un objet ` QLineF ` au constructeur de `QGraphicsLineItem`, ou appelez la fonction ` setLine()`. La fonction ` line()` renvoie la ligne actuelle. Par défaut, la ligne est noire et sa largeur est égale à 0, mais vous pouvez modifier ces paramètres en appelant la fonction ` setPen()`.

Segment de droite tracé près de l'origine

QGraphicsLineItem utilise la ligne et la largeur du stylo pour fournir une implémentation raisonnable des fonctions boundingRect(), shape() et contains(). La fonction paint() dessine la ligne à l'aide du stylo associé à l'élément.

Voir également QGraphicsPathItem, QGraphicsRectItem, QGraphicsEllipseItem, QGraphicsTextItem, QGraphicsPolygonItem, QGraphicsPixmapItem et le cadre de vue graphique.

Documentation sur les types de membres

[anonymous] enum

Valeur renvoyée par la fonction virtuelle ` type()`.

ConstanteValeurDescription
QGraphicsLineItem::Type6Un élément graphique de type ligne

Documentation des fonctions membres

[explicit] QGraphicsLineItem::QGraphicsLineItem(QGraphicsItem *parent = nullptr)

Crée un objet `QGraphicsLineItem`. L'objet ` parent ` est transmis au constructeur de ` QGraphicsItem`.

Voir aussi QGraphicsScene::addItem().

[explicit] QGraphicsLineItem::QGraphicsLineItem(const QLineF &line, QGraphicsItem *parent = nullptr)

Crée un objet `QGraphicsLineItem` en utilisant ` line ` comme ligne par défaut. ` parent ` est transmis au constructeur de ` QGraphicsItem`.

Voir également QGraphicsScene::addItem().

[explicit] QGraphicsLineItem::QGraphicsLineItem(qreal x1, qreal y1, qreal x2, qreal y2, QGraphicsItem *parent = nullptr)

Crée un objet `QGraphicsLineItem` en utilisant la ligne reliant (x1, y1) et (x2, y2) comme ligne par défaut. La classe ` parent ` est transmise au constructeur de ` QGraphicsItem`.

Voir également QGraphicsScene::addItem().

[virtual noexcept] QGraphicsLineItem::~QGraphicsLineItem()

Supprime l'QGraphicsLineItem.

[override virtual] QRectF QGraphicsLineItem::boundingRect() const

Réimplémente : QGraphicsItem::boundingRect() const.

[override virtual] bool QGraphicsLineItem::contains(const QPointF &point) const

Réimplémente : QGraphicsItem::contains(const QPointF &point) const.

[override virtual] bool QGraphicsLineItem::isObscuredBy(const QGraphicsItem *item) const

Réimplémente : QGraphicsItem::isObscuredBy(const QGraphicsItem *item) const.

QLineF QGraphicsLineItem::line() const

Renvoie la ligne de l'élément, ou une ligne nulle si aucune ligne n'a été définie.

Voir aussi setLine().

[override virtual] QPainterPath QGraphicsLineItem::opaqueArea() const

Réimplémente : QGraphicsItem::opaqueArea() const.

[override virtual] void QGraphicsLineItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr)

Réimplémente : QGraphicsItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget).

QPen QGraphicsLineItem::pen() const

Renvoie le stylo de l'élément, ou un stylo noir plein de largeur nulle si aucun stylo n'a été défini.

Voir aussi setPen().

void QGraphicsLineItem::setLine(const QLineF &line)

Définit la ligne de l'élément sur l'line indiquée.

Voir aussi line().

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

Définit la ligne de l'élément comme étant celle comprise entre (x1, y1) et (x2, y2).

Cela revient à appeler setLine(QLineF(x1, y1, x2, y2)).

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

void QGraphicsLineItem::setPen(const QPen &pen)

Définit le stylo de l'élément sur pen. Si aucun stylo n'est défini, la ligne sera tracée à l'aide d'un stylo noir plein de largeur 0.

Voir aussi pen().

[override virtual] QPainterPath QGraphicsLineItem::shape() const

Réimplémente : QGraphicsItem::shape() const.

[override virtual] int QGraphicsLineItem::type() const

Réimplémente : QGraphicsItem::type() const.

© 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.