QCPItemAnchor Class Reference

An anchor of an item to which positions can be attached to. More...

#include <plot2d.h>

Inheritance diagram for QCPItemAnchor:

Public Member Functions
	QCPItemAnchor (QCustomPlot *parentPlot, QCPAbstractItem *parentItem, const QString name, int anchorId=-1)
virtual	~QCPItemAnchor ()
QString	name () const
virtual QPointF	pixelPoint () const

Protected Member Functions
void	addChild (QCPItemPosition *pos)
void	removeChild (QCPItemPosition *pos)

Protected Attributes
QCustomPlot *	mParentPlot
QCPAbstractItem *	mParentItem
int	mAnchorId
QString	mName
QSet< QCPItemPosition * >	mChildren

Friends
class	QCPItemPosition

Detailed Description

An anchor of an item to which positions can be attached to.

An item (QCPAbstractItem) may have one or more anchors. Unlike QCPItemPosition, an anchor doesn't control anything on its item, but provides a way to tie other items via their positions to the anchor.

For example, a QCPItemRect is defined by its positions topLeft and bottomRight. Additionally it has various anchors like top, topRight or bottomLeft etc. So you can attach the start (which is a QCPItemPosition) of a QCPItemLine to one of the anchors by calling QCPItemPosition::setParentAnchor on start, passing the wanted anchor of the QCPItemRect. This way the start of the line will now always follow the respective anchor location on the rect item.

Note that QCPItemPosition derives from QCPItemAnchor, so every position can also serve as an anchor to other positions.

To learn how to provide anchors in your own item subclasses, see the subclassing section of the QCPAbstractItem documentation.

Constructor & Destructor Documentation

QCPItemAnchor::QCPItemAnchor	(	QCustomPlot *	parentPlot,
		QCPAbstractItem *	parentItem,
		const QString	name,
		int	anchorId = -1
	)

Creates a new QCPItemAnchor. You shouldn't create QCPItemAnchor instances directly, even if you want to make a new item subclass. Use QCPAbstractItem::createAnchor instead, as explained in the subclassing section of the QCPAbstractItem documentation.

QCPItemAnchor::~QCPItemAnchor ( )

virtual

Member Function Documentation

void QCPItemAnchor::addChild ( QCPItemPosition *  pos )

protected

QString QCPItemAnchor::name ( ) const

inline

QPointF QCPItemAnchor::pixelPoint ( ) const

virtual

Returns the final absolute pixel position of the QCPItemAnchor on the QCustomPlot surface.

The pixel information is internally retrieved via QCPAbstractItem::anchorPixelPosition of the parent item, QCPItemAnchor is just an intermediary.

Reimplemented in QCPItemPosition.

void QCPItemAnchor::removeChild ( QCPItemPosition *  pos )

protected

Friends And Related Function Documentation

friend class QCPItemPosition

friend

Member Data Documentation

int QCPItemAnchor::mAnchorId

protected

QSet<QCPItemPosition*> QCPItemAnchor::mChildren

protected

QString QCPItemAnchor::mName

protected

QCPAbstractItem* QCPItemAnchor::mParentItem

protected

QCustomPlot* QCPItemAnchor::mParentPlot

protected

---

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

• C:/Users/mpeniak/Dropbox/Aquila/trunk/aquila/include/plot2d.h
• C:/Users/mpeniak/Dropbox/Aquila/trunk/aquila/src/plot2d.cpp