En esta página

QGraphicsLineItem Class

La clase `QGraphicsLineItem` proporciona un elemento de línea que se puede añadir a un ` QGraphicsScene`. Más información...

Encabezado: #include <QGraphicsLineItem>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado de: QGraphicsItem

Tipos públicos

enum { Type }

Funciones públicas

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)

Funciones públicas reimplementadas

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

Descripción detallada

Para configurar la línea del elemento, pasa un objeto ` QLineF ` al constructor de `QGraphicsLineItem` o llama a la función ` setLine()`. La función ` line()` devuelve la línea actual. Por defecto, la línea es negra y tiene un ancho de 0, pero puedes cambiarlo llamando a ` setPen()`.

Segmento de recta trazado cerca del origen

QGraphicsLineItem utiliza la línea y el grosor del trazo para proporcionar una implementación adecuada de boundingRect(), shape() y contains(). La función paint() dibuja la línea utilizando el trazo asociado al elemento.

Véase también QGraphicsPathItem, QGraphicsRectItem, QGraphicsEllipseItem, QGraphicsTextItem, QGraphicsPolygonItem, QGraphicsPixmapItem y Graphics View Framework.

Documentación sobre los tipos de miembros

[anonymous] enum

El valor devuelto por la función virtual type().

ConstanteValorDescripción
QGraphicsLineItem::Type6Un elemento de línea gráfica

Documentación de la función miembro

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

Crea un objeto `QGraphicsLineItem`. Se pasa ` parent ` al constructor de ` QGraphicsItem`.

Véase también QGraphicsScene::addItem().

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

Crea un objeto `QGraphicsLineItem` utilizando ` line ` como línea predeterminada. El objeto ` parent ` se pasa al constructor de ` QGraphicsItem`.

Véase también QGraphicsScene::addItem().

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

Crea un objeto `QGraphicsLineItem` utilizando como línea predeterminada la línea que une los puntos (x1, y1) y (x2, y2). Se pasa ` parent ` al constructor de ` QGraphicsItem`.

Véase también QGraphicsScene::addItem().

[virtual noexcept] QGraphicsLineItem::~QGraphicsLineItem()

Destruye el « QGraphicsLineItem ».

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

Reimplementa: ` QGraphicsItem::boundingRect()` const.

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

Reimplementa: QGraphicsItem::contains(const QPointF &point) const.

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

Reimplementa: QGraphicsItem::isObscuredBy(const QGraphicsItem *item) const.

QLineF QGraphicsLineItem::line() const

Devuelve la línea del elemento, o una línea nula si no se ha establecido ninguna línea.

Véase también setLine().

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

Reimplementa: ` QGraphicsItem::opaqueArea()` const.

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

Reimplementa: ` QGraphicsItem::paint` (`QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)`.

QPen QGraphicsLineItem::pen() const

Devuelve el trazo del elemento o, si no se ha establecido ningún trazo, un trazo negro sólido de ancho 0.

Véase también setPen().

void QGraphicsLineItem::setLine(const QLineF &line)

Establece la línea del elemento en el valor dado line.

Véase también line().

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

Establece la línea del elemento como la línea que une (x1, y1) y (x2, y2).

Esto equivale a llamar a setLine(QLineF(x1, y1, x2, y2)).

Se trata de una función sobrecargada.

void QGraphicsLineItem::setPen(const QPen &pen)

Establece el trazo del elemento en « pen ». Si no se especifica ningún trazo, la línea se dibujará con un trazo negro sólido de ancho 0.

Véase también pen().

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

Reimplementa: QGraphicsItem::shape() const.

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

Reimplementa: 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.