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:

Collaboration diagram for KDChart::TextArea:

Signals
void	positionChanged (TextArea *)

Public Member Functions
void	alignToReferencePoint (const RelativePosition &position)
const QObject *	autoReferenceArea () const
BackgroundAttributes	backgroundAttributes () const
QPolygon	boundingPolygon () const
bool	compare (const AbstractAreaBase *other) const
	Returns true if both areas have the same settings. More...
Qt::Orientations	expandingDirections () const override
	pure virtual in QLayoutItem More...
FrameAttributes	frameAttributes () const
QRect	geometry () const override
	pure virtual in QLayoutItem More...
void	getFrameLeadings (int &left, int &top, int &right, int &bottom) const
virtual bool	intersects (const TextLayoutItem &other, const QPointF &myPos, const QPointF &otherPos) const
virtual bool	intersects (const TextLayoutItem &other, const QPoint &myPos, const QPoint &otherPos) const
bool	isEmpty () const override
	pure virtual in QLayoutItem More...
virtual int	marginWidth () const
QSize	maximumSize () const override
	pure virtual in QLayoutItem More...
QSize	minimumSize () const override
	pure virtual in QLayoutItem More...
void	paint (QPainter *) override
void	paintAll (QPainter &painter) override
	Call paintAll, if you want the background and the frame to be drawn before the normal paint() is invoked automatically. More...
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. More...
virtual void	paintFrame (QPainter &painter, const QRect &rectangle)
virtual void	paintIntoRect (QPainter &painter, const QRect &rect)
	Draws the background and frame, then calls paint(). More...
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)
void	setGeometry (const QRect &r) override
	pure virtual in QLayoutItem More...
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. More...
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. More...
QSize	sizeHint () const override
	pure virtual in QLayoutItem More...
virtual void	sizeHintChanged () const
	Report changed size hint: ask the parent widget to recalculate the layout. More...
virtual QSize	sizeHintUnrotated () const
QString	text () const
Qt::Alignment	textAlignment () const
TextAttributes	textAttributes () const
	Returns the text attributes to be used for this item. More...
	~TextArea () override

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
QRect	areaGeometry () const override
QRect	innerRect () const
void	positionHasChanged () override
	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 AbstractAreaBase, TextLayoutItem, and QObject. The reason for this triple inheritance is that neither AbstractAreaBase nor TextLayoutItem inherit QObject.

Definition at line 47 of file KDChartTextArea.h.

Constructor & Destructor Documentation

TextArea::~TextArea ( )

override

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 81 of file KDChartAbstractAreaBase.cpp.

QRect TextArea::areaGeometry ( ) const

overrideprotectedvirtual

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 239 of file KDChartLayoutItems.cpp.

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

BackgroundAttributes AbstractAreaBase::backgroundAttributes ( ) const

inherited

Definition at line 111 of file KDChartAbstractAreaBase.cpp.

References d.

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

QPolygon KDChart::TextLayoutItem::boundingPolygon ( ) const

inherited

Definition at line 392 of file KDChartLayoutItems.cpp.

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

bool AbstractAreaBase::compare ( const AbstractAreaBase *  other ) const

inherited

Returns true if both areas have the same settings.

Definition at line 71 of file KDChartAbstractAreaBase.cpp.

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

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

Qt::Orientations KDChart::TextLayoutItem::expandingDirections ( ) const

overrideinherited

pure virtual in QLayoutItem

Definition at line 298 of file KDChartLayoutItems.cpp.

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

FrameAttributes AbstractAreaBase::frameAttributes ( ) const

inherited

Definition at line 97 of file KDChartAbstractAreaBase.cpp.

References d.

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

QRect KDChart::TextLayoutItem::geometry ( ) const

overrideinherited

pure virtual in QLayoutItem

Definition at line 303 of file KDChartLayoutItems.cpp.

Referenced by areaGeometry(), KDChart::TextBubbleLayoutItem::geometry(), paintAll(), paintIntoRect(), and rotatedRect().

void AbstractAreaBase::getFrameLeadings ( int &  left, int &  top, int &  right, int &  bottom  ) const

inherited

Definition at line 213 of file KDChartAbstractAreaBase.cpp.

References d.

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

QRect AbstractAreaBase::innerRect ( ) const

protectedinherited

Definition at line 225 of file KDChartAbstractAreaBase.cpp.

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

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

bool KDChart::TextLayoutItem::intersects ( const TextLayoutItem &  other, const QPointF &  myPos, const QPointF &  otherPos  ) const

virtualinherited

Definition at line 398 of file KDChartLayoutItems.cpp.

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

bool KDChart::TextLayoutItem::intersects ( const TextLayoutItem &  other, const QPoint &  myPos, const QPoint &  otherPos  ) const

virtualinherited

Definition at line 403 of file KDChartLayoutItems.cpp.

References KDChart::TextLayoutItem::boundingPolygon().

bool KDChart::TextLayoutItem::isEmpty ( ) const

overrideinherited

pure virtual in QLayoutItem

Definition at line 308 of file KDChartLayoutItems.cpp.

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

int KDChart::TextLayoutItem::marginWidth ( ) const

virtualinherited

Definition at line 447 of file KDChartLayoutItems.cpp.

References KDChart::TextAttributes::rotation().

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

QSize KDChart::TextLayoutItem::maximumSize ( ) const

overrideinherited

pure virtual in QLayoutItem

Definition at line 313 of file KDChartLayoutItems.cpp.

References KDChart::TextLayoutItem::sizeHint().

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

QSize KDChart::TextLayoutItem::minimumSize ( ) const

overrideinherited

pure virtual in QLayoutItem

Definition at line 318 of file KDChartLayoutItems.cpp.

References KDChart::TextLayoutItem::sizeHint().

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

void KDChart::TextLayoutItem::paint ( QPainter *  painter )

overridevirtualinherited

Implements KDChart::AbstractLayoutItem.

Definition at line 490 of file KDChartLayoutItems.cpp.

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

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

void TextArea::paintAll ( QPainter &  painter )

overridevirtual

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 findSharingAxisDiagrams(), and paintIntoRect().

void AbstractAreaBase::paintBackground ( QPainter &  painter, const QRect &  rectangle  )

virtualinherited

Definition at line 189 of file KDChartAbstractAreaBase.cpp.

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

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

void AbstractAreaBase::paintBackgroundAttributes ( QPainter &  painter, const QRect &  rectangle, const KDChart::BackgroundAttributes &  attributes  )

staticinherited

Definition at line 118 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 findSharingAxisDiagrams(), and KDChart::AbstractAreaBase::paintBackground().

void KDChart::AbstractLayoutItem::paintCtx ( PaintContext *  context )

virtualinherited

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

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

Definition at line 72 of file KDChartLayoutItems.cpp.

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

void AbstractAreaBase::paintFrame ( QPainter &  painter, const QRect &  rectangle  )

virtualinherited

Definition at line 205 of file KDChartAbstractAreaBase.cpp.

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

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

void AbstractAreaBase::paintFrameAttributes ( QPainter &  painter, const QRect &  rectangle, const KDChart::FrameAttributes &  attributes  )

staticinherited

Definition at line 168 of file KDChartAbstractAreaBase.cpp.

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

Referenced by findSharingAxisDiagrams(), and 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 77 of file KDChartLayoutItems.h.

void KDChart::TextArea::positionChanged ( TextArea *  )

signal

Referenced by positionHasChanged().

void TextArea::positionHasChanged ( )

overrideprotectedvirtual

Reimplemented from KDChart::AbstractAreaBase.

Definition at line 107 of file KDChartTextArea.cpp.

References positionChanged().

QFont KDChart::TextLayoutItem::realFont ( ) const

virtualinherited

Definition at line 386 of file KDChartLayoutItems.cpp.

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

qreal KDChart::TextLayoutItem::realFontSize ( ) const

virtualinherited

Definition at line 369 of file KDChartLayoutItems.cpp.

References KDChart::TextAttributes::calculatedFontSize().

void KDChart::AbstractLayoutItem::removeFromParentLayout ( )

inherited

Definition at line 81 of file KDChartLayoutItems.h.

Referenced by findSharingAxisDiagrams(), KDChart::Chart::takeCoordinatePlane(), and KDChart::Chart::takeHeaderFooter().

void KDChart::TextLayoutItem::setAutoReferenceArea ( const QObject *  area )

inherited

Definition at line 232 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 102 of file KDChartAbstractAreaBase.cpp.

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

void AbstractAreaBase::setFrameAttributes ( const FrameAttributes &  a )

inherited

Definition at line 88 of file KDChartAbstractAreaBase.cpp.

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

Referenced by KDChart::Legend::clone(), and KDChart::Legend::~Legend().

void KDChart::TextLayoutItem::setGeometry ( const QRect &  r )

overrideinherited

pure virtual in QLayoutItem

Definition at line 323 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 73 of file KDChartLayoutItems.h.

Referenced by KDChart::Chart::addHeaderFooter(), findSharingAxisDiagrams(), and KDChart::Chart::takeHeaderFooter().

void KDChart::AbstractLayoutItem::setParentWidget ( QWidget *  widget )

virtualinherited

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 59 of file KDChartLayoutItems.cpp.

References KDChart::AbstractLayoutItem::mParent.

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

void KDChart::TextLayoutItem::setText ( const QString &  text )

inherited

Definition at line 244 of file KDChartLayoutItems.cpp.

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

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 258 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 277 of file KDChartLayoutItems.cpp.

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

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

QSize KDChart::TextLayoutItem::sizeHint ( ) const

overrideinherited

pure virtual in QLayoutItem

Definition at line 411 of file KDChartLayoutItems.cpp.

References KDChart::TextAttributes::rotation(), and KDChart::AbstractLayoutItem::sizeHintChanged().

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

void KDChart::AbstractLayoutItem::sizeHintChanged ( ) const

virtualinherited

Report changed size hint: ask the parent widget to recalculate the layout.

Definition at line 81 of file KDChartLayoutItems.cpp.

References KDChart::AbstractLayoutItem::mParent.

Referenced by KDChart::TextLayoutItem::sizeHint().

QSize KDChart::TextLayoutItem::sizeHintUnrotated ( ) const

virtualinherited

Definition at line 425 of file KDChartLayoutItems.cpp.

References KDChart::GlobalMeasureScaling::paintDevice(), and KDChart::TextLayoutItem::realFont().

QString KDChart::TextLayoutItem::text ( ) const

inherited

Definition at line 253 of file KDChartLayoutItems.cpp.

Referenced by KDChart::HeaderFooter::clone(), KDChart::HeaderFooter::compare(), KDChart::TextLayoutItem::setText(), and KDChart::TextBubbleLayoutItem::text().

Qt::Alignment KDChart::TextLayoutItem::textAlignment ( ) const

inherited

Definition at line 267 of file KDChartLayoutItems.cpp.

KDChart::TextAttributes KDChart::TextLayoutItem::textAttributes ( ) const

inherited

Returns the text attributes to be used for this item.

See also

setTextAttributes

Definition at line 292 of file KDChartLayoutItems.cpp.

Referenced by KDChart::Chart::addHeaderFooter(), KDChart::HeaderFooter::clone(), KDChart::HeaderFooter::compare(), and KDChart::TextBubbleLayoutItem::textAttributes().

Member Data Documentation

QWidget* KDChart::AbstractLayoutItem::mParent

protectedinherited

Definition at line 91 of file KDChartLayoutItems.h.

Referenced by KDChart::AbstractLayoutItem::setParentWidget(), KDChart::TextLayoutItem::setText(), KDChart::TextLayoutItem::setTextAlignment(), KDChart::TextLayoutItem::setTextAttributes(), and KDChart::AbstractLayoutItem::sizeHintChanged().

QLayout* KDChart::AbstractLayoutItem::mParentLayout

protectedinherited

Definition at line 92 of file KDChartLayoutItems.h.

Referenced by KDChart::AutoSpacerLayoutItem::paint().

---

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

• KDChartTextArea.h
• KDChartTextArea.cpp