#include <qgraphicsitem.h>

Inheritance diagram for QGraphicsPathItem:

Collaboration diagram for QGraphicsPathItem:

Public Types
enum	{ Type = 2 }

enum	{ Type = 2 }

Public Types inherited from QGraphicsItem
enum	GraphicsItemFlag { ItemIsMovable = 0x1 , ItemIsSelectable = 0x2 , ItemIsFocusable = 0x4 , ItemClipsToShape = 0x8 , ItemClipsChildrenToShape = 0x10 , ItemIgnoresTransformations = 0x20 , ItemIgnoresParentOpacity = 0x40 , ItemDoesntPropagateOpacityToChildren = 0x80 , ItemStacksBehindParent = 0x100 , ItemUsesExtendedStyleOption = 0x200 , ItemHasNoContents = 0x400 , ItemSendsGeometryChanges = 0x800 , ItemAcceptsInputMethod = 0x1000 , ItemNegativeZStacksBehindParent = 0x2000 , ItemIsPanel = 0x4000 , ItemIsFocusScope = 0x8000 , ItemSendsScenePositionChanges = 0x10000 , ItemStopsClickFocusPropagation = 0x20000 , ItemStopsFocusHandling = 0x40000 , ItemContainsChildrenInShape = 0x80000 }

enum	GraphicsItemChange { ItemPositionChange , ItemVisibleChange = 2 , ItemEnabledChange , ItemSelectedChange , ItemParentChange , ItemChildAddedChange , ItemChildRemovedChange , ItemTransformChange , ItemPositionHasChanged , ItemTransformHasChanged , ItemSceneChange , ItemVisibleHasChanged , ItemEnabledHasChanged , ItemSelectedHasChanged , ItemParentHasChanged , ItemSceneHasChanged , ItemCursorChange , ItemCursorHasChanged , ItemToolTipChange , ItemToolTipHasChanged , ItemFlagsChange , ItemFlagsHaveChanged , ItemZValueChange , ItemZValueHasChanged , ItemOpacityChange , ItemOpacityHasChanged , ItemScenePositionHasChanged , ItemRotationChange , ItemRotationHasChanged , ItemScaleChange , ItemScaleHasChanged , ItemTransformOriginPointChange , ItemTransformOriginPointHasChanged }

enum	CacheMode { NoCache , ItemCoordinateCache , DeviceCoordinateCache }

enum	PanelModality { NonModal , PanelModal , SceneModal }

enum	{ Type = 1 , UserType = 65536 }

Public Member Functions
int	type () const override

	QGraphicsPathItem (QGraphicsItem *parent=nullptr)

	QGraphicsPathItem (const QPainterPath &path, QGraphicsItem *parent=nullptr)

	~QGraphicsPathItem ()

QPainterPath	path () const

void	setPath (const QPainterPath &path)

QRectF	boundingRect () const override

QPainterPath	shape () const override

bool	contains (const QPointF &point) const override

void	paint (QPainter painter, const QStyleOptionGraphicsItem option, QWidget *widget=nullptr) override

bool	isObscuredBy (const QGraphicsItem *item) const override

QPainterPath	opaqueArea () const override

int	type () const override

Public Member Functions inherited from QAbstractGraphicsShapeItem
	QAbstractGraphicsShapeItem (QGraphicsItem *parent=nullptr)

	~QAbstractGraphicsShapeItem ()

QPen	pen () const

void	setPen (const QPen &pen)

QBrush	brush () const

void	setBrush (const QBrush &brush)

Public Member Functions inherited from QGraphicsItem
	QGraphicsItem (QGraphicsItem *parent=nullptr)

virtual	~QGraphicsItem ()

QGraphicsScene *	scene () const

QGraphicsItem *	parentItem () const

QGraphicsItem *	topLevelItem () const

QGraphicsObject *	parentObject () const

QGraphicsWidget *	parentWidget () const

QGraphicsWidget *	topLevelWidget () const

QGraphicsWidget *	window () const

QGraphicsItem *	panel () const

void	setParentItem (QGraphicsItem *parent)

QList< QGraphicsItem * >	childItems () const

bool	isWidget () const

bool	isWindow () const

bool	isPanel () const

QGraphicsObject *	toGraphicsObject ()

const QGraphicsObject *	toGraphicsObject () const

QGraphicsItemGroup *	group () const

void	setGroup (QGraphicsItemGroup *group)

GraphicsItemFlags	flags () const

void	setFlag (GraphicsItemFlag flag, bool enabled=true)

void	setFlags (GraphicsItemFlags flags)

CacheMode	cacheMode () const

void	setCacheMode (CacheMode mode, const QSize &cacheSize=QSize())

PanelModality	panelModality () const

void	setPanelModality (PanelModality panelModality)

bool	isBlockedByModalPanel (QGraphicsItem **blockingPanel=nullptr) const

QCursor	cursor () const

void	setCursor (const QCursor &cursor)

bool	hasCursor () const

void	unsetCursor ()

bool	isVisible () const

bool	isVisibleTo (const QGraphicsItem *parent) const

void	setVisible (bool visible)

void	hide ()

void	show ()

bool	isEnabled () const

void	setEnabled (bool enabled)

bool	isSelected () const

void	setSelected (bool selected)

bool	acceptDrops () const

void	setAcceptDrops (bool on)

qreal	opacity () const

qreal	effectiveOpacity () const

void	setOpacity (qreal opacity)

Qt::MouseButtons	acceptedMouseButtons () const

void	setAcceptedMouseButtons (Qt::MouseButtons buttons)

bool	acceptHoverEvents () const

void	setAcceptHoverEvents (bool enabled)

bool	acceptTouchEvents () const

void	setAcceptTouchEvents (bool enabled)

bool	filtersChildEvents () const

void	setFiltersChildEvents (bool enabled)

bool	handlesChildEvents () const

void	setHandlesChildEvents (bool enabled)

bool	isActive () const

void	setActive (bool active)

bool	hasFocus () const

void	setFocus (Qt::FocusReason focusReason=Qt::OtherFocusReason)

void	clearFocus ()

QGraphicsItem *	focusProxy () const

void	setFocusProxy (QGraphicsItem *item)

QGraphicsItem *	focusItem () const

QGraphicsItem *	focusScopeItem () const

void	grabMouse ()

void	ungrabMouse ()

void	grabKeyboard ()

void	ungrabKeyboard ()

QPointF	pos () const

qreal	x () const

void	setX (qreal x)

qreal	y () const

void	setY (qreal y)

QPointF	scenePos () const

void	setPos (const QPointF &pos)

void	setPos (qreal x, qreal y)

void	moveBy (qreal dx, qreal dy)

void	ensureVisible (const QRectF &rect=QRectF(), int xmargin=50, int ymargin=50)

void	ensureVisible (qreal x, qreal y, qreal w, qreal h, int xmargin=50, int ymargin=50)

QTransform	transform () const

QTransform	sceneTransform () const

QTransform	deviceTransform (const QTransform &viewportTransform) const

QTransform	itemTransform (const QGraphicsItem other, bool ok=nullptr) const

void	setTransform (const QTransform &matrix, bool combine=false)

void	resetTransform ()

void	setRotation (qreal angle)

qreal	rotation () const

void	setScale (qreal scale)

qreal	scale () const

QList< QGraphicsTransform * >	transformations () const

void	setTransformations (const QList< QGraphicsTransform * > &transformations)

QPointF	transformOriginPoint () const

void	setTransformOriginPoint (const QPointF &origin)

void	setTransformOriginPoint (qreal ax, qreal ay)

virtual void	advance (int phase)

qreal	zValue () const

void	setZValue (qreal z)

void	stackBefore (const QGraphicsItem *sibling)

QRectF	childrenBoundingRect () const

QRectF	sceneBoundingRect () const

bool	isClipped () const

QPainterPath	clipPath () const

virtual bool	collidesWithItem (const QGraphicsItem *other, 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

bool	isObscured (const QRectF &rect=QRectF()) const

bool	isObscured (qreal x, qreal y, qreal w, qreal h) const

QRegion	boundingRegion (const QTransform &itemToDeviceTransform) const

qreal	boundingRegionGranularity () const

void	setBoundingRegionGranularity (qreal granularity)

void	update (const QRectF &rect=QRectF())

void	update (qreal x, qreal y, qreal width, qreal height)

void	scroll (qreal dx, qreal dy, const QRectF &rect=QRectF())

QPointF	mapToItem (const QGraphicsItem *item, const QPointF &point) const

QPointF	mapToParent (const QPointF &point) const

QPointF	mapToScene (const QPointF &point) const

QPolygonF	mapToItem (const QGraphicsItem *item, const QRectF &rect) const

QPolygonF	mapToParent (const QRectF &rect) const

QPolygonF	mapToScene (const QRectF &rect) const

QRectF	mapRectToItem (const QGraphicsItem *item, const QRectF &rect) const

QRectF	mapRectToParent (const QRectF &rect) const

QRectF	mapRectToScene (const QRectF &rect) const

QPolygonF	mapToItem (const QGraphicsItem *item, const QPolygonF &polygon) const

QPolygonF	mapToParent (const QPolygonF &polygon) const

QPolygonF	mapToScene (const QPolygonF &polygon) const

QPainterPath	mapToItem (const QGraphicsItem *item, const QPainterPath &path) const

QPainterPath	mapToParent (const QPainterPath &path) const

QPainterPath	mapToScene (const QPainterPath &path) const

QPointF	mapFromItem (const QGraphicsItem *item, const QPointF &point) const

QPointF	mapFromParent (const QPointF &point) const

QPointF	mapFromScene (const QPointF &point) const

QPolygonF	mapFromItem (const QGraphicsItem *item, const QRectF &rect) const

QPolygonF	mapFromParent (const QRectF &rect) const

QPolygonF	mapFromScene (const QRectF &rect) const

QRectF	mapRectFromItem (const QGraphicsItem *item, const QRectF &rect) const

QRectF	mapRectFromParent (const QRectF &rect) const

QRectF	mapRectFromScene (const QRectF &rect) const

QPolygonF	mapFromItem (const QGraphicsItem *item, const QPolygonF &polygon) const

QPolygonF	mapFromParent (const QPolygonF &polygon) const

QPolygonF	mapFromScene (const QPolygonF &polygon) const

QPainterPath	mapFromItem (const QGraphicsItem *item, const QPainterPath &path) const

QPainterPath	mapFromParent (const QPainterPath &path) const

QPainterPath	mapFromScene (const QPainterPath &path) const

QPointF	mapToItem (const QGraphicsItem *item, qreal x, qreal y) const

QPointF	mapToParent (qreal x, qreal y) const

QPointF	mapToScene (qreal x, qreal y) const

QPolygonF	mapToItem (const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const

QPolygonF	mapToParent (qreal x, qreal y, qreal w, qreal h) const

QPolygonF	mapToScene (qreal x, qreal y, qreal w, qreal h) const

QRectF	mapRectToItem (const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const

QRectF	mapRectToParent (qreal x, qreal y, qreal w, qreal h) const

QRectF	mapRectToScene (qreal x, qreal y, qreal w, qreal h) const

QPointF	mapFromItem (const QGraphicsItem *item, qreal x, qreal y) const

QPointF	mapFromParent (qreal x, qreal y) const

QPointF	mapFromScene (qreal x, qreal y) const

QPolygonF	mapFromItem (const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const

QPolygonF	mapFromParent (qreal x, qreal y, qreal w, qreal h) const

QPolygonF	mapFromScene (qreal x, qreal y, qreal w, qreal h) const

QRectF	mapRectFromItem (const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const

QRectF	mapRectFromParent (qreal x, qreal y, qreal w, qreal h) const

QRectF	mapRectFromScene (qreal x, qreal y, qreal w, qreal h) const

bool	isAncestorOf (const QGraphicsItem *child) const

QGraphicsItem *	commonAncestorItem (const QGraphicsItem *other) const

bool	isUnderMouse () const

QVariant	data (int key) const

void	setData (int key, const QVariant &value)

Qt::InputMethodHints	inputMethodHints () const

void	setInputMethodHints (Qt::InputMethodHints hints)

void	installSceneEventFilter (QGraphicsItem *filterItem)

void	removeSceneEventFilter (QGraphicsItem *filterItem)

Protected Member Functions
bool	supportsExtension (Extension extension) const override

void	setExtension (Extension extension, const QVariant &variant) override

QVariant	extension (const QVariant &variant) const override

Protected Member Functions inherited from QAbstractGraphicsShapeItem
	QAbstractGraphicsShapeItem (QAbstractGraphicsShapeItemPrivate &dd, QGraphicsItem *parent)

Protected Member Functions inherited from QGraphicsItem
void	updateMicroFocus ()

virtual bool	sceneEventFilter (QGraphicsItem watched, QEvent event)

virtual bool	sceneEvent (QEvent *event)

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	hoverMoveEvent (QGraphicsSceneHoverEvent *event)

virtual void	hoverLeaveEvent (QGraphicsSceneHoverEvent *event)

virtual void	keyPressEvent (QKeyEvent *event)

virtual void	keyReleaseEvent (QKeyEvent *event)

virtual void	mousePressEvent (QGraphicsSceneMouseEvent *event)

virtual void	mouseMoveEvent (QGraphicsSceneMouseEvent *event)

virtual void	mouseReleaseEvent (QGraphicsSceneMouseEvent *event)

virtual void	mouseDoubleClickEvent (QGraphicsSceneMouseEvent *event)

virtual void	wheelEvent (QGraphicsSceneWheelEvent *event)

virtual void	inputMethodEvent (QInputMethodEvent *event)

virtual QVariant	inputMethodQuery (Qt::InputMethodQuery query) const

virtual QVariant	itemChange (GraphicsItemChange change, const QVariant &value)

	QGraphicsItem (QGraphicsItemPrivate &dd, QGraphicsItem *parent)

void	addToIndex ()

void	removeFromIndex ()

void	prepareGeometryChange ()

Additional Inherited Members
Protected Types inherited from QGraphicsItem
enum	Extension { UserExtension = 0x80000000 }

Protected Attributes inherited from QGraphicsItem
QScopedPointer< QGraphicsItemPrivate >	d_ptr

Related Functions inherited from QGraphicsItem
T	qgraphicsitem_cast (QGraphicsItem *item)

Detailed Description

[17]

The QGraphicsPathItem class provides a path item that you can add to a QGraphicsScene.

[18]

Since: 4.2

\inmodule QtWidgets

To set the item's path, pass a QPainterPath to QGraphicsPathItem's constructor, or call the setPath() function. The path() function returns the current path.

QGraphicsPathItem uses the path to provide a reasonable implementation of boundingRect(), shape(), and contains(). The paint() function draws the path using the item's associated pen and brush, which you can set by calling the setPen() and setBrush() functions.

See also: QGraphicsRectItem, QGraphicsEllipseItem, QGraphicsPolygonItem, QGraphicsTextItem, QGraphicsLineItem, QGraphicsPixmapItem, {Graphics View Framework}

Definition at line 259 of file src_gui_graphicsview_qgraphicsitem.cpp.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

Enumerator
Type

Definition at line 262 of file src_gui_graphicsview_qgraphicsitem.cpp.

◆ anonymous enum

anonymous enum

Enumerator
Type

Definition at line 631 of file qgraphicsitem.h.

Constructor & Destructor Documentation

◆ QGraphicsPathItem() [1/2]

QGraphicsPathItem::QGraphicsPathItem ( QGraphicsItem * parent = nullptr )

explicit

Constructs a QGraphicsPath. parent is passed to QAbstractGraphicsShapeItem's constructor.

See also: QGraphicsScene::addItem()

Definition at line 8210 of file qgraphicsitem.cpp.

◆ QGraphicsPathItem() [2/2]

QGraphicsPathItem::QGraphicsPathItem	(	const QPainterPath &	path,
		QGraphicsItem *	parent = `nullptr`
	)

explicit

Constructs a QGraphicsPath item using path as the default path. parent is passed to QAbstractGraphicsShapeItem's constructor.

See also: QGraphicsScene::addItem()

Definition at line 8196 of file qgraphicsitem.cpp.

Here is the call graph for this function:

◆ ~QGraphicsPathItem()

QGraphicsPathItem::~QGraphicsPathItem ( )

Destroys the QGraphicsPathItem.

Definition at line 8218 of file qgraphicsitem.cpp.

Member Function Documentation

◆ boundingRect()

QRectF QGraphicsPathItem::boundingRect ( ) const

overridevirtual

\reimp

Implements QGraphicsItem.

Definition at line 8253 of file qgraphicsitem.cpp.

Here is the call graph for this function:

◆ contains()

bool QGraphicsPathItem::contains ( const QPointF & point ) const

overridevirtual

\reimp

Reimplemented from QGraphicsItem.

Definition at line 8279 of file qgraphicsitem.cpp.

Here is the call graph for this function:

◆ extension()

QVariant QGraphicsPathItem::extension ( const QVariant & variant ) const

overrideprotectedvirtual

Reimplemented from QGraphicsItem.

Definition at line 8345 of file qgraphicsitem.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isObscuredBy()

bool QGraphicsPathItem::isObscuredBy ( const QGraphicsItem * item ) const

overridevirtual

\reimp

Reimplemented from QAbstractGraphicsShapeItem.

Definition at line 8303 of file qgraphicsitem.cpp.

Here is the call graph for this function:

◆ opaqueArea()

QPainterPath QGraphicsPathItem::opaqueArea ( ) const

overridevirtual

\reimp

Reimplemented from QAbstractGraphicsShapeItem.

Definition at line 8311 of file qgraphicsitem.cpp.

Here is the call graph for this function:

◆ paint()

void QGraphicsPathItem::paint	(	QPainter *	painter,
		const QStyleOptionGraphicsItem *	option,
		QWidget *	widget = `nullptr`
	)

overridevirtual

\reimp

Implements QGraphicsItem.

Definition at line 8287 of file qgraphicsitem.cpp.

Here is the call graph for this function:

◆ path()

QPainterPath QGraphicsPathItem::path ( ) const

Returns the item's path as a QPainterPath. If no item has been set, an empty QPainterPath is returned.

See also: setPath()

Definition at line 8228 of file qgraphicsitem.cpp.

Here is the caller graph for this function:

◆ setExtension()

void QGraphicsPathItem::setExtension	(	Extension	extension,
		const QVariant &	variant
	)

overrideprotectedvirtual

Reimplemented from QGraphicsItem.

Definition at line 8336 of file qgraphicsitem.cpp.

Here is the call graph for this function:

◆ setPath()

void QGraphicsPathItem::setPath ( const QPainterPath & path )

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

See also: path()

Definition at line 8239 of file qgraphicsitem.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ shape()

QPainterPath QGraphicsPathItem::shape ( ) const

overridevirtual

\reimp

Reimplemented from QGraphicsItem.

Definition at line 8270 of file qgraphicsitem.cpp.

Here is the caller graph for this function:

◆ supportsExtension()

bool QGraphicsPathItem::supportsExtension ( Extension extension ) const

overrideprotectedvirtual

Reimplemented from QGraphicsItem.

Definition at line 8327 of file qgraphicsitem.cpp.

Here is the call graph for this function:

◆ type() [1/2]

int QGraphicsPathItem::type ( ) const

inlineoverridevirtual

\reimp

Reimplemented from QGraphicsItem.

Definition at line 263 of file src_gui_graphicsview_qgraphicsitem.cpp.

◆ type() [2/2]

int QGraphicsPathItem::type ( ) const

overridevirtual

Returns the type of an item as an int. All standard graphicsitem classes are associated with a unique value; see QGraphicsItem::Type. This type information is used by qgraphicsitem_cast() to distinguish between types.

The default implementation (in QGraphicsItem) returns UserType.

To enable use of qgraphicsitem_cast() with a custom item, reimplement this function and declare a Type enum value equal to your custom item's type. Custom items must return a value larger than or equal to UserType (65536).

For example:

See also: UserType

Reimplemented from QGraphicsItem.

The documentation for this class was generated from the following files:

src/widgets/doc/snippets/code/src_gui_graphicsview_qgraphicsitem.cpp
src/widgets/graphicsview/qgraphicsitem.h
src/widgets/graphicsview/qgraphicsitem.cpp

Public Types

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ anonymous enum

◆ anonymous enum

Constructor & Destructor Documentation

◆ QGraphicsPathItem() [1/2]

◆ QGraphicsPathItem() [2/2]

◆ ~QGraphicsPathItem()

Member Function Documentation

◆ boundingRect()

◆ contains()

◆ extension()

◆ isObscuredBy()

◆ opaqueArea()

◆ paint()

◆ path()

◆ setExtension()

◆ setPath()

◆ shape()

◆ supportsExtension()

◆ type() [1/2]

◆ type() [2/2]