CopperSpice API  1.7.2
QGraphicsLineItem Class Reference

QGraphicsLineItem class provides a line item you can add to a QGraphicsScene. More...

Inheritance diagram for QGraphicsLineItem:

Public Methods

 QGraphicsLineItem (const QLineF &line, QGraphicsItem *parent=nullptr)
 QGraphicsLineItem (QGraphicsItem *parent=nullptr)
 QGraphicsLineItem (qreal x1, qreal y1, qreal x2, qreal y2, QGraphicsItem *parent=nullptr)
 ~QGraphicsLineItem ()
QRectF boundingRect () const override
bool contains (const QPointF &point) const override
bool isObscuredBy (const QGraphicsItem *graphicsItem) const override
QLineF line () const
QPainterPath opaqueArea () const override
void paint (QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget=nullptr) override
QPen pen () const
void setLine (const QLineF &line)
void setLine (qreal x1, qreal y1, qreal x2, qreal y2)
void setPen (const QPen &pen)
QPainterPath shape () const override
int type () const override
- Public Methods inherited from QGraphicsItem
 QGraphicsItem (QGraphicsItem *parent=nullptr)
virtual ~QGraphicsItem ()
bool acceptDrops () const
Qt::MouseButtons acceptedMouseButtons () const
bool acceptHoverEvents () const
bool acceptTouchEvents () const
virtual void advance (int phase)
QRegion boundingRegion (const QTransform &itemToDeviceTransform) const
qreal boundingRegionGranularity () const
CacheMode cacheMode () const
QList< QGraphicsItem * > childItems () const
QRectF childrenBoundingRect () const
void clearFocus ()
QPainterPath clipPath () const
virtual bool collidesWithItem (const QGraphicsItem *graphicsItem, Qt::ItemSelectionMode mode=Qt::IntersectsItemShape) const
virtual bool collidesWithPath (const QPainterPath &path, Qt::ItemSelectionMode mode=Qt::IntersectsItemShape) const
QList< QGraphicsItem * > collidingItems (Qt::ItemSelectionMode mode=Qt::IntersectsItemShape) const
QGraphicsItem * commonAncestorItem (const QGraphicsItem *graphicsItem) const
QCursor cursor () const
QVariant data (int key) const
QTransform deviceTransform (const QTransform &viewportTransform) const
qreal effectiveOpacity () const
void ensureVisible (const QRectF &rectF=QRectF (), int xmargin=50, int ymargin=50)
void ensureVisible (qreal x, qreal y, qreal width, qreal height, int xmargin=50, int ymargin=50)
bool filtersChildEvents () const
GraphicsItemFlags flags () const
QGraphicsItem * focusItem () const
QGraphicsItem * focusProxy () const
void grabKeyboard ()
void grabMouse ()
QGraphicsEffectgraphicsEffect () const
QGraphicsItemGroupgroup () const
bool handlesChildEvents () const
bool hasCursor () const
bool hasFocus () const
void hide ()
Qt::InputMethodHints inputMethodHints () const
void installSceneEventFilter (QGraphicsItem *filterItem)
bool isActive () const
bool isAncestorOf (const QGraphicsItem *graphicsItem) const
bool isBlockedByModalPanel (QGraphicsItem **blockingPanel=nullptr) const
bool isClipped () const
bool isEnabled () const
bool isObscured (const QRectF &rectF=QRectF ()) const
bool isObscured (qreal x, qreal y, qreal width, qreal height) const
bool isPanel () const
bool isSelected () const
bool isUnderMouse () const
bool isVisible () const
bool isVisibleTo (const QGraphicsItem *graphicsItem) const
bool isWidget () const
bool isWindow () const
QTransform itemTransform (const QGraphicsItem *graphicsItem, bool *ok=nullptr) const
QPainterPath mapFromItem (const QGraphicsItem *graphicsItem, const QPainterPath &path) const
QPointF mapFromItem (const QGraphicsItem *graphicsItem, const QPointF &point) const
QPolygonF mapFromItem (const QGraphicsItem *graphicsItem, const QPolygonF &polygon) const
QPolygonF mapFromItem (const QGraphicsItem *graphicsItem, const QRectF &rectF) const
QPointF mapFromItem (const QGraphicsItem *graphicsItem, qreal x, qreal y) const
QPolygonF mapFromItem (const QGraphicsItem *graphicsItem, qreal x, qreal y, qreal width, qreal height) const
QPainterPath mapFromParent (const QPainterPath &path) const
QPointF mapFromParent (const QPointF &point) const
QPolygonF mapFromParent (const QPolygonF &polygon) const
QPolygonF mapFromParent (const QRectF &rectF) const
QPointF mapFromParent (qreal x, qreal y) const
QPolygonF mapFromParent (qreal x, qreal y, qreal width, qreal height) const
QPainterPath mapFromScene (const QPainterPath &path) const
QPointF mapFromScene (const QPointF &point) const
QPolygonF mapFromScene (const QPolygonF &polygon) const
QPolygonF mapFromScene (const QRectF &rectF) const
QPointF mapFromScene (qreal x, qreal y) const
QPolygonF mapFromScene (qreal x, qreal y, qreal width, qreal height) const
QRectF mapRectFromItem (const QGraphicsItem *graphicsItem, const QRectF &rectF) const
QRectF mapRectFromItem (const QGraphicsItem *graphicsItem, qreal x, qreal y, qreal width, qreal height) const
QRectF mapRectFromParent (const QRectF &rectF) const
QRectF mapRectFromParent (qreal x, qreal y, qreal width, qreal height) const
QRectF mapRectFromScene (const QRectF &rectF) const
QRectF mapRectFromScene (qreal x, qreal y, qreal width, qreal height) const
QRectF mapRectToItem (const QGraphicsItem *graphicsItem, const QRectF &rectF) const
QRectF mapRectToItem (const QGraphicsItem *graphicsItem, qreal x, qreal y, qreal width, qreal height) const
QRectF mapRectToParent (const QRectF &rectF) const
QRectF mapRectToParent (qreal x, qreal y, qreal width, qreal height) const
QRectF mapRectToScene (const QRectF &rectF) const
QRectF mapRectToScene (qreal x, qreal y, qreal width, qreal height) const
QPainterPath mapToItem (const QGraphicsItem *graphicsItem, const QPainterPath &path) const
QPointF mapToItem (const QGraphicsItem *graphicsItem, const QPointF &point) const
QPolygonF mapToItem (const QGraphicsItem *graphicsItem, const QPolygonF &polygon) const
QPolygonF mapToItem (const QGraphicsItem *graphicsItem, const QRectF &rectF) const
QPointF mapToItem (const QGraphicsItem *graphicsItem, qreal x, qreal y) const
QPolygonF mapToItem (const QGraphicsItem *graphicsItem, qreal x, qreal y, qreal width, qreal height) const
QPainterPath mapToParent (const QPainterPath &path) const
QPointF mapToParent (const QPointF &point) const
QPolygonF mapToParent (const QPolygonF &polygon) const
QPolygonF mapToParent (const QRectF &rectF) const
QPointF mapToParent (qreal x, qreal y) const
QPolygonF mapToParent (qreal x, qreal y, qreal width, qreal height) const
QPainterPath mapToScene (const QPainterPath &path) const
QPointF mapToScene (const QPointF &point) const
QPolygonF mapToScene (const QPolygonF &polygon) const
QPolygonF mapToScene (const QRectF &rectF) const
QPointF mapToScene (qreal x, qreal y) const
QPolygonF mapToScene (qreal x, qreal y, qreal width, qreal height) const
QMatrix matrix () const
void moveBy (qreal dx, qreal dy)
qreal opacity () const
QGraphicsItem * panel () const
PanelModality panelModality () const
QGraphicsItem * parentItem () const
QGraphicsObjectparentObject () const
QGraphicsWidgetparentWidget () const
QPointF pos () const
void removeSceneEventFilter (QGraphicsItem *filterItem)
void resetMatrix ()
void resetTransform ()
qreal rotation () const
qreal scale () const
QGraphicsScenescene () const
QRectF sceneBoundingRect () const
QMatrix sceneMatrix () const
QPointF scenePos () const
QTransform sceneTransform () const
void scroll (qreal dx, qreal dy, const QRectF &rectF=QRectF ())
void setAcceptDrops (bool on)
void setAcceptedMouseButtons (Qt::MouseButtons buttons)
void setAcceptHoverEvents (bool enabled)
void setAcceptTouchEvents (bool enabled)
void setActive (bool active)
void setBoundingRegionGranularity (qreal granularity)
void setCacheMode (CacheMode mode, const QSize &cacheSize=QSize ())
void setCursor (const QCursor &cursor)
void setData (int key, const QVariant &value)
void setEnabled (bool enabled)
void setFiltersChildEvents (bool enabled)
void setFlag (GraphicsItemFlag flag, bool enabled=true)
void setFlags (GraphicsItemFlags flags)
void setFocus (Qt::FocusReason focusReason=Qt::OtherFocusReason)
void setFocusProxy (QGraphicsItem *graphicsItem)
void setGraphicsEffect (QGraphicsEffect *effect)
void setGroup (QGraphicsItemGroup *group)
void setHandlesChildEvents (bool enabled)
void setInputMethodHints (Qt::InputMethodHints hints)
void setMatrix (const QMatrix &matrix, bool combine=false)
void setOpacity (qreal opacity)
void setPanelModality (PanelModality panelModality)
void setParentItem (QGraphicsItem *parent)
void setPos (const QPointF &pos)
void setPos (qreal x, qreal y)
void setRotation (qreal angle)
void setScale (qreal factor)
void setSelected (bool selected)
void setToolTip (const QString &toolTip)
void setTransform (const QTransform &matrix, bool combine=false)
void setTransformations (const QList< QGraphicsTransform * > &transformations)
void setTransformOriginPoint (const QPointF &origin)
void setTransformOriginPoint (qreal x, qreal y)
void setVisible (bool visible)
void setX (qreal x)
void setY (qreal y)
void setZValue (qreal z)
void show ()
void stackBefore (const QGraphicsItem *graphicsItem)
QGraphicsObjecttoGraphicsObject ()
const QGraphicsObjecttoGraphicsObject () const
QString toolTip () const
QGraphicsItem * topLevelItem () const
QGraphicsWidgettopLevelWidget () const
QTransform transform () const
QList< QGraphicsTransform * > transformations () const
QPointF transformOriginPoint () const
void ungrabKeyboard ()
void ungrabMouse ()
void unsetCursor ()
void update (const QRectF &rectF=QRectF ())
void update (qreal x, qreal y, qreal width, qreal height)
QGraphicsWidgetwindow () const
qreal x () const
qreal y () const
qreal zValue () const

Additional Inherited Members

- Public Typedefs inherited from QGraphicsItem
using GraphicsItemFlags = QFlags< GraphicsItemFlag >
- Public Types inherited from QGraphicsItem
enum  CacheMode
enum  GraphicsItemChange
enum  GraphicsItemFlag
enum  PanelModality
- Protected Methods inherited from QGraphicsItem
virtual void contextMenuEvent (QGraphicsSceneContextMenuEvent *event)
virtual void dragEnterEvent (QGraphicsSceneDragDropEvent *event)
virtual void dragLeaveEvent (QGraphicsSceneDragDropEvent *event)
virtual void dragMoveEvent (QGraphicsSceneDragDropEvent *event)
virtual void dropEvent (QGraphicsSceneDragDropEvent *event)
virtual void focusInEvent (QFocusEvent *event)
virtual void focusOutEvent (QFocusEvent *event)
virtual void hoverEnterEvent (QGraphicsSceneHoverEvent *event)
virtual void hoverLeaveEvent (QGraphicsSceneHoverEvent *event)
virtual void hoverMoveEvent (QGraphicsSceneHoverEvent *event)
virtual void inputMethodEvent (QInputMethodEvent *event)
virtual QVariant inputMethodQuery (Qt::InputMethodQuery query) const
virtual QVariant itemChange (GraphicsItemChange change, const QVariant &value)
virtual void keyPressEvent (QKeyEvent *event)
virtual void keyReleaseEvent (QKeyEvent *event)
virtual void mouseDoubleClickEvent (QGraphicsSceneMouseEvent *event)
virtual void mouseMoveEvent (QGraphicsSceneMouseEvent *event)
virtual void mousePressEvent (QGraphicsSceneMouseEvent *event)
virtual void mouseReleaseEvent (QGraphicsSceneMouseEvent *event)
void prepareGeometryChange ()
virtual bool sceneEvent (QEvent *event)
virtual bool sceneEventFilter (QGraphicsItem *watched, QEvent *event)
void updateMicroFocus ()
virtual void wheelEvent (QGraphicsSceneWheelEvent *event)

Detailed Description

The QGraphicsLineItem class provides a line item you can add to a QGraphicsScene.

To set the item's line pass a QLineF to QGraphicsLineItem's constructor or call the setLine() method. The line() method returns the current line. By default the line is black with a width of 0. You can alter this by calling setPen().

QGraphicsLineItem uses the line and the pen width to provide a reasonable implementation of boundingRect(), shape(), and contains(). The paint() function draws the line using the item's associated pen.

See also
QGraphicsPathItem, QGraphicsRectItem, QGraphicsEllipseItem, QGraphicsTextItem, QGraphicsPolygonItem, QGraphicsPixmapItem, and Graphics View System.

Constructor & Destructor Documentation

QGraphicsLineItem::QGraphicsLineItem ( QGraphicsItem parent = nullptr)

Constructs a QGraphicsLineItem. The parent is passed to QGraphicsItem's constructor.

See also
QGraphicsLineItem::QGraphicsLineItem ( const QLineF line,
QGraphicsItem parent = nullptr 

Constructs a QGraphicsLineItem, using line as the default line. The parent is passed to QGraphicsItem's constructor.

See also
QGraphicsLineItem::QGraphicsLineItem ( qreal  x1,
qreal  y1,
qreal  x2,
qreal  y2,
QGraphicsItem parent = nullptr 

Constructs a QGraphicsLineItem, using the line between (x1, y1) and (x2, y2) as the default line. parent is passed to QGraphicsItem's constructor.

See also
QGraphicsLineItem::~QGraphicsLineItem ( )

Destroys the QGraphicsLineItem.

Method Documentation

QRectF QGraphicsLineItem::boundingRect ( ) const

Reimplemented from QGraphicsItem::boundingRect().

Implements QGraphicsItem.

bool QGraphicsLineItem::contains ( const QPointF point) const

Reimplemented from QGraphicsItem::contains().

Reimplemented from QGraphicsItem.

bool QGraphicsLineItem::isObscuredBy ( const QGraphicsItem graphicsItem) const

Reimplemented from QGraphicsItem::isObscuredBy().

Reimplemented from QGraphicsItem.

QLineF QGraphicsLineItem::line ( ) const

Returns the item's line, or a null line if no line has been set.

See also
QPainterPath QGraphicsLineItem::opaqueArea ( ) const

Reimplemented from QGraphicsItem::opaqueArea().

Reimplemented from QGraphicsItem.

void QGraphicsLineItem::paint ( QPainter painter,
const QStyleOptionGraphicsItem option,
QWidget widget = nullptr 

Reimplemented from QGraphicsItem::paint().

Implements QGraphicsItem.

QPen QGraphicsLineItem::pen ( ) const

Returns the item's pen, or a black solid 0-width pen if no pen has been set.

See also
void QGraphicsLineItem::setLine ( const QLineF line)

Sets the item's line to be the given line.

See also
void QGraphicsLineItem::setLine ( qreal  x1,
qreal  y1,
qreal  x2,
qreal  y2 

Sets the item's line to be the line between (x1, y1) and (x2, y2). This is the same as calling setLine(QLineF(x1, y1, x2, y2)).

void QGraphicsLineItem::setPen ( const QPen pen)

Sets the item's pen to pen. If no pen is set, the line will be painted using a black solid 0-width pen.

See also
QPainterPath QGraphicsLineItem::shape ( ) const

Reimplemented from QGraphicsItem::shape().

Reimplemented from QGraphicsItem.

int QGraphicsLineItem::type ( ) const

Reimplemented from QGraphicsItem::type().

Reimplemented from QGraphicsItem.