KDChart::TextArea Class Reference

A text area in the chart with a background, a frame, etc. More...

#include <KDChartTextArea.h>

Inheritance diagram for KDChart::TextArea:

[legend]

Collaboration diagram for KDChart::TextArea:

[legend]

List of all members.

Signals
void	positionChanged (TextArea *)
Public Member Functions
void	alignToReferencePoint (const RelativePosition &position)
const QObject *	autoReferenceArea () const
BackgroundAttributes	backgroundAttributes () const
bool	compare (const AbstractAreaBase *other) const
	Returns true if both areas have the same settings.
virtual Qt::Orientations	expandingDirections () const
	pure virtual in QLayoutItem
FrameAttributes	frameAttributes () const
virtual QRect	geometry () const
	pure virtual in QLayoutItem
void	getFrameLeadings (int &left, int &top, int &right, int &bottom) const
virtual bool	intersects (const TextLayoutItem &other, const QPoint &myPos, const QPoint &otherPos) const
virtual bool	intersects (const TextLayoutItem &other, const QPointF &myPos, const QPointF &otherPos) const
virtual bool	isEmpty () const
	pure virtual in QLayoutItem
virtual QSize	maximumSize () const
	pure virtual in QLayoutItem
virtual QSize	minimumSize () const
	pure virtual in QLayoutItem
virtual void	paint (QPainter *)
void	paintAll (QPainter &painter)
	Call paintAll, if you want the background and the frame to be drawn before the normal paint() is invoked automatically.
virtual void	paintBackground (QPainter &painter, const QRect &rectangle)
virtual void	paintCtx (PaintContext *context)
	Default impl: Paint the complete item using its layouted position and size.
virtual void	paintFrame (QPainter &painter, const QRect &rectangle)
virtual void	paintIntoRect (QPainter &painter, const QRect &rect)
	Draws the background and frame, then calls paint().
QLayout *	parentLayout ()
virtual QFont	realFont () const
virtual qreal	realFontSize () const
void	removeFromParentLayout ()
void	setAutoReferenceArea (const QObject *area)
void	setBackgroundAttributes (const BackgroundAttributes &a)
void	setFrameAttributes (const FrameAttributes &a)
virtual void	setGeometry (const QRect &r)
	pure virtual in QLayoutItem
void	setParentLayout (QLayout *lay)
virtual void	setParentWidget (QWidget *widget)
	Inform the item about its widget: This enables the item, to trigger that widget's update, whenever the size of the item's contents has changed.
void	setText (const QString &text)
void	setTextAlignment (Qt::Alignment)
void	setTextAttributes (const TextAttributes &a)
	Use this to specify the text attributes to be used for this item.
virtual QSize	sizeHint () const
	pure virtual in QLayoutItem
virtual QSize	sizeHintAndRotatedCorners (QPoint &topLeftPt, QPoint &topRightPt, QPoint &bottomRightPt, QPoint &bottomLeftPt) const
virtual void	sizeHintChanged () const
	Report changed size hint: ask the parent widget to recalculate the layout.
virtual QSize	sizeHintUnrotated () const
QString	text () const
Qt::Alignment	textAlignment () const
TextAttributes	textAttributes () const
	Returns the text attributes to be used for this item.
virtual	~TextArea ()
Static Public Member Functions
static void	paintBackgroundAttributes (QPainter &painter, const QRect &rectangle, const KDChart::BackgroundAttributes &attributes)
static void	paintFrameAttributes (QPainter &painter, const QRect &rectangle, const KDChart::FrameAttributes &attributes)
Protected Member Functions
virtual QRect	areaGeometry () const
QRect	innerRect () const
virtual void	positionHasChanged ()
	TextArea ()
Protected Attributes
QWidget *	mParent
QLayout *	mParentLayout

Detailed Description

A text area in the chart with a background, a frame, etc.

TextArea is the base class for all text containing non-widget chart elements that have a set of background attributes and frame attributes, such as headers or footers.

Note:: This class inherits from AbstractAreaBase, TextLayoutItem, QObject. The reason for this tripple inheritance is that neither AbstractAreaBase nor TextLayoutItem are QObject.

Definition at line 47 of file KDChartTextArea.h.

Constructor & Destructor Documentation

TextArea::~TextArea ( ) [virtual]

Definition at line 57 of file KDChartTextArea.cpp.

TextArea::TextArea ( ) [protected]

Definition at line 49 of file KDChartTextArea.cpp.

Member Function Documentation

void AbstractAreaBase::alignToReferencePoint ( const RelativePosition & position ) [inherited]

Definition at line 88 of file KDChartAbstractAreaBase.cpp.

QRect TextArea::areaGeometry ( ) const [protected, virtual]

Implements KDChart::AbstractAreaBase.

Definition at line 102 of file KDChartTextArea.cpp.

References KDChart::TextLayoutItem::geometry().

Referenced by paintAll().

const QObject * KDChart::TextLayoutItem::autoReferenceArea ( ) const [inherited]

Definition at line 242 of file KDChartLayoutItems.cpp.

Referenced by KDChart::TextBubbleLayoutItem::autoReferenceArea(), KDChart::HeaderFooter::compare(), and KDChart::HeaderFooter::setParent().

BackgroundAttributes AbstractAreaBase::backgroundAttributes ( ) const [inherited]

Definition at line 118 of file KDChartAbstractAreaBase.cpp.

References d.

Referenced by KDChart::AbstractAreaBase::compare(), and updateCommonBrush().

bool AbstractAreaBase::compare ( const AbstractAreaBase * other ) const [inherited]

Returns true if both areas have the same settings.

Definition at line 73 of file KDChartAbstractAreaBase.cpp.

References KDChart::AbstractAreaBase::backgroundAttributes(), and KDChart::AbstractAreaBase::frameAttributes().

Qt::Orientations KDChart::TextLayoutItem::expandingDirections ( ) const [virtual, inherited]

pure virtual in QLayoutItem

Definition at line 301 of file KDChartLayoutItems.cpp.

Referenced by KDChart::TextBubbleLayoutItem::expandingDirections().

FrameAttributes AbstractAreaBase::frameAttributes ( ) const [inherited]

Definition at line 104 of file KDChartAbstractAreaBase.cpp.

References d.

Referenced by KDChart::Legend::clone(), KDChart::AbstractAreaBase::compare(), and updateCommonBrush().

QRect KDChart::TextLayoutItem::geometry ( ) const [virtual, inherited]

pure virtual in QLayoutItem

Definition at line 306 of file KDChartLayoutItems.cpp.

Referenced by areaGeometry(), KDChart::TextBubbleLayoutItem::geometry(), KDChart::TextLayoutItem::paint(), paintAll(), KDChart::CartesianAxis::paintCtx(), and paintIntoRect().

void AbstractAreaBase::getFrameLeadings	(	int &	left,
		int &	top,
		int &	right,
		int &	bottom
	)			const `[inherited]`

Definition at line 210 of file KDChartAbstractAreaBase.cpp.

References d.

Referenced by KDChart::AbstractAreaBase::innerRect(), and KDChart::AbstractAreaWidget::paintAll().

QRect AbstractAreaBase::innerRect ( ) const [protected, inherited]

Definition at line 226 of file KDChartAbstractAreaBase.cpp.

References KDChart::AbstractAreaBase::areaGeometry(), and KDChart::AbstractAreaBase::getFrameLeadings().

Referenced by paintAll(), and KDChart::AbstractArea::paintAll().

bool KDChart::TextLayoutItem::intersects	(	const TextLayoutItem &	other,
		const QPoint &	myPos,
		const QPoint &	otherPos
	)			const `[virtual, inherited]`

Definition at line 470 of file KDChartLayoutItems.cpp.

References PI, and KDChart::TextAttributes::rotation().

bool KDChart::TextLayoutItem::intersects	(	const TextLayoutItem &	other,
		const QPointF &	myPos,
		const QPointF &	otherPos
	)			const `[virtual, inherited]`

Definition at line 465 of file KDChartLayoutItems.cpp.

Referenced by KDChart::CartesianAxis::paintCtx().

bool KDChart::TextLayoutItem::isEmpty ( ) const [virtual, inherited]

pure virtual in QLayoutItem

Definition at line 311 of file KDChartLayoutItems.cpp.

Referenced by KDChart::TextBubbleLayoutItem::isEmpty().

QSize KDChart::TextLayoutItem::maximumSize ( ) const [virtual, inherited]

pure virtual in QLayoutItem

Definition at line 316 of file KDChartLayoutItems.cpp.

References KDChart::TextLayoutItem::sizeHint().

Referenced by KDChart::TextBubbleLayoutItem::maximumSize().

QSize KDChart::TextLayoutItem::minimumSize ( ) const [virtual, inherited]

pure virtual in QLayoutItem

Definition at line 321 of file KDChartLayoutItems.cpp.

References KDChart::TextLayoutItem::sizeHint().

Referenced by KDChart::TextBubbleLayoutItem::minimumSize().

void KDChart::TextLayoutItem::paint ( QPainter * painter ) [virtual, inherited]

Implements KDChart::AbstractLayoutItem.

Definition at line 618 of file KDChartLayoutItems.cpp.

References KDChart::TextAttributes::autoShrink(), KDChart::TextLayoutItem::geometry(), KDChart::TextAttributes::pen(), KDChart::TextLayoutItem::realFont(), rotatedRect(), KDChart::TextAttributes::rotation(), and KDChart::PrintingParameters::scalePen().

Referenced by KDChart::TextBubbleLayoutItem::paint(), paintAll(), and KDChart::CartesianAxis::paintCtx().

void TextArea::paintAll ( QPainter & painter ) [virtual]

Call paintAll, if you want the background and the frame to be drawn before the normal paint() is invoked automatically.

Reimplemented from KDChart::AbstractLayoutItem.

Definition at line 80 of file KDChartTextArea.cpp.

References areaGeometry(), KDChart::TextLayoutItem::geometry(), KDChart::AbstractAreaBase::innerRect(), KDChart::TextLayoutItem::paint(), KDChart::AbstractAreaBase::paintBackground(), KDChart::AbstractAreaBase::paintFrame(), and KDChart::TextLayoutItem::setGeometry().

Referenced by paintIntoRect().

void AbstractAreaBase::paintBackground	(	QPainter &	painter,
		const QRect &	rectangle
	)			`[virtual, inherited]`

Definition at line 194 of file KDChartAbstractAreaBase.cpp.

References d, and KDChart::AbstractAreaBase::paintBackgroundAttributes().

Referenced by paintAll(), KDChart::AbstractAreaWidget::paintAll(), and KDChart::AbstractArea::paintAll().

void AbstractAreaBase::paintBackgroundAttributes	(	QPainter &	painter,
		const QRect &	rectangle,
		const KDChart::BackgroundAttributes &	attributes
	)			`[static, inherited]`

Definition at line 125 of file KDChartAbstractAreaBase.cpp.

References KDChart::BackgroundAttributes::BackgroundPixmapModeCentered, KDChart::BackgroundAttributes::BackgroundPixmapModeNone, KDChart::BackgroundAttributes::BackgroundPixmapModeScaled, KDChart::BackgroundAttributes::BackgroundPixmapModeStretched, KDChart::BackgroundAttributes::brush(), KDChart::BackgroundAttributes::isVisible(), KDChart::BackgroundAttributes::pixmap(), and KDChart::BackgroundAttributes::pixmapMode().

Referenced by KDChart::AbstractAreaBase::paintBackground().

void KDChart::AbstractLayoutItem::paintCtx ( PaintContext * context ) [virtual, inherited]

Default impl: Paint the complete item using its layouted position and size.

Reimplemented in KDChart::CartesianAxis, KDChart::LeveyJenningsAxis, and KDChart::TernaryAxis.

Definition at line 75 of file KDChartLayoutItems.cpp.

References KDChart::AbstractLayoutItem::paint(), and KDChart::PaintContext::painter().

void AbstractAreaBase::paintFrame	(	QPainter &	painter,
		const QRect &	rectangle
	)			`[virtual, inherited]`

Definition at line 202 of file KDChartAbstractAreaBase.cpp.

References d, and KDChart::AbstractAreaBase::paintFrameAttributes().

Referenced by paintAll(), KDChart::AbstractAreaWidget::paintAll(), and KDChart::AbstractArea::paintAll().

void AbstractAreaBase::paintFrameAttributes	(	QPainter &	painter,
		const QRect &	rectangle,
		const KDChart::FrameAttributes &	attributes
	)			`[static, inherited]`

Definition at line 175 of file KDChartAbstractAreaBase.cpp.

References KDChart::FrameAttributes::isVisible(), KDChart::FrameAttributes::pen(), and KDChart::PrintingParameters::scalePen().

Referenced by KDChart::AbstractAreaBase::paintFrame().

void TextArea::paintIntoRect	(	QPainter &	painter,
		const QRect &	rect
	)			`[virtual]`

Draws the background and frame, then calls paint().

In most cases there is no need to overwrite this method in a derived class, but you would overwrite TextLayoutItem::paint() instead.

Definition at line 68 of file KDChartTextArea.cpp.

References KDChart::TextLayoutItem::geometry(), paintAll(), and KDChart::TextLayoutItem::setGeometry().

QLayout* KDChart::AbstractLayoutItem::parentLayout ( ) [inherited]

Definition at line 76 of file KDChartLayoutItems.h.

void KDChart::TextArea::positionChanged ( TextArea * ) [signal]

Referenced by positionHasChanged().

void TextArea::positionHasChanged ( ) [protected, virtual]

Reimplemented from KDChart::AbstractAreaBase.

Definition at line 107 of file KDChartTextArea.cpp.

References positionChanged().

QFont KDChart::TextLayoutItem::realFont ( ) const [virtual, inherited]

Definition at line 442 of file KDChartLayoutItems.cpp.

Referenced by KDChart::TextLayoutItem::paint(), and KDChart::CartesianAxis::paintCtx().

qreal KDChart::TextLayoutItem::realFontSize ( ) const [virtual, inherited]

Definition at line 422 of file KDChartLayoutItems.cpp.

References KDChart::TextAttributes::calculatedFontSize().

void KDChart::AbstractLayoutItem::removeFromParentLayout ( ) [inherited]

Definition at line 80 of file KDChartLayoutItems.h.

Referenced by KDChart::Chart::takeCoordinatePlane().

void KDChart::TextLayoutItem::setAutoReferenceArea ( const QObject * area ) [inherited]

Definition at line 235 of file KDChartLayoutItems.cpp.

References KDChart::TextLayoutItem::sizeHint().

Referenced by KDChart::TextBubbleLayoutItem::setAutoReferenceArea(), and KDChart::HeaderFooter::setParent().

void AbstractAreaBase::setBackgroundAttributes ( const BackgroundAttributes & a ) [inherited]

Definition at line 109 of file KDChartAbstractAreaBase.cpp.

References d, and KDChart::AbstractAreaBase::positionHasChanged().

void AbstractAreaBase::setFrameAttributes ( const FrameAttributes & a ) [inherited]

Definition at line 95 of file KDChartAbstractAreaBase.cpp.

References d, and KDChart::AbstractAreaBase::positionHasChanged().

Referenced by KDChart::Legend::clone().

void KDChart::TextLayoutItem::setGeometry ( const QRect & r ) [virtual, inherited]

pure virtual in QLayoutItem

Definition at line 326 of file KDChartLayoutItems.cpp.

Referenced by paintAll(), KDChart::CartesianAxis::paintCtx(), paintIntoRect(), and KDChart::TextBubbleLayoutItem::setGeometry().

void KDChart::AbstractLayoutItem::setParentLayout ( QLayout * lay ) [inherited]

Definition at line 72 of file KDChartLayoutItems.h.

void KDChart::AbstractLayoutItem::setParentWidget ( QWidget * widget ) [virtual, inherited]

Inform the item about its widget: This enables the item, to trigger that widget's update, whenever the size of the item's contents has changed.

Thus, you need to call setParentWidget on every item, that has a non-fixed size.

Definition at line 62 of file KDChartLayoutItems.cpp.

References KDChart::AbstractLayoutItem::mParent.

Referenced by KDChart::HeaderFooter::setParent(), and KDChart::AbstractCartesianDiagram::takeAxis().

void KDChart::TextLayoutItem::setText ( const QString & text ) [inherited]

Definition at line 247 of file KDChartLayoutItems.cpp.

References KDChart::AbstractLayoutItem::mParent, and KDChart::TextLayoutItem::sizeHint().

Referenced by KDChart::Widget::addHeaderFooter(), KDChart::HeaderFooter::clone(), KDChart::CartesianAxis::paintCtx(), and KDChart::TextBubbleLayoutItem::setText().

void KDChart::TextLayoutItem::setTextAlignment ( Qt::Alignment alignment ) [inherited]

Definition at line 261 of file KDChartLayoutItems.cpp.

References KDChart::AbstractLayoutItem::mParent.

void KDChart::TextLayoutItem::setTextAttributes ( const TextAttributes & a ) [inherited]

Use this to specify the text attributes to be used for this item.

See also:: textAttributes

Definition at line 280 of file KDChartLayoutItems.cpp.

References KDChart::TextAttributes::font(), KDChart::AbstractLayoutItem::mParent, and KDChart::TextLayoutItem::sizeHint().

Referenced by KDChart::HeaderFooter::clone(), KDChart::CartesianAxis::paintCtx(), and KDChart::TextBubbleLayoutItem::setTextAttributes().

QSize KDChart::TextLayoutItem::sizeHint ( ) const [virtual, inherited]

pure virtual in QLayoutItem

Definition at line 513 of file KDChartLayoutItems.cpp.

References KDChart::TextLayoutItem::sizeHintAndRotatedCorners().

Referenced by KDChart::TextLayoutItem::maximumSize(), KDChart::TextLayoutItem::minimumSize(), KDChart::CartesianAxis::paintCtx(), KDChart::TextLayoutItem::setAutoReferenceArea(), KDChart::TextLayoutItem::setText(), KDChart::TextLayoutItem::setTextAttributes(), and KDChart::TextBubbleLayoutItem::sizeHint().

QSize KDChart::TextLayoutItem::sizeHintAndRotatedCorners	(	QPoint &	topLeftPt,
		QPoint &	topRightPt,
		QPoint &	bottomRightPt,
		QPoint &	bottomLeftPt
	)			const `[virtual, inherited]`