KDChart::HeaderFooter Class Reference

A header or footer displaying text above or below charts. More...

#include <KDChartHeaderFooter.h>

Inheritance diagram for KDChart::HeaderFooter:

Collaboration diagram for KDChart::HeaderFooter:

Public Types
enum	HeaderFooterType {   Header,   Footer }

Signals
void	destroyedHeaderFooter (HeaderFooter *)
void	positionChanged (HeaderFooter *)
void	positionChanged (TextArea *)

Public Member Functions
void	alignToReferencePoint (const RelativePosition &position)
const QObject *	autoReferenceArea () const
BackgroundAttributes	backgroundAttributes () const
QPolygon	boundingPolygon () const
virtual HeaderFooter *	clone () const
	Creates an exact copy of this header/footer. More...
bool	compare (const HeaderFooter &other) const
bool	compare (const AbstractAreaBase *other) const
	Returns true if both areas have the same settings. More...
virtual Qt::Orientations	expandingDirections () const
	pure virtual in QLayoutItem More...
FrameAttributes	frameAttributes () const
virtual QRect	geometry () const
	pure virtual in QLayoutItem More...
void	getFrameLeadings (int &left, int &top, int &right, int &bottom) const
	HeaderFooter (Chart *parent=0)
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
virtual bool	isEmpty () const
	pure virtual in QLayoutItem More...
virtual int	marginWidth () const
virtual QSize	maximumSize () const
	pure virtual in QLayoutItem More...
virtual QSize	minimumSize () const
	pure virtual in QLayoutItem More...
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. 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 ()
Position	position () const
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 More...
void	setParent (QObject *parent)
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	setPosition (Position position)
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...
void	setType (HeaderFooterType type)
virtual QSize	sizeHint () const
	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...
HeaderFooterType	type () const
virtual	~HeaderFooter ()

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 ()

Protected Attributes
QWidget *	mParent
QLayout *	mParentLayout

Detailed Description

A header or footer displaying text above or below charts.

Definition at line 37 of file KDChartHeaderFooter.h.

Member Enumeration Documentation

enum KDChart::HeaderFooter::HeaderFooterType

Enumerator
Header
Footer

Definition at line 51 of file KDChartHeaderFooter.h.

Constructor & Destructor Documentation

HeaderFooter::HeaderFooter

(

Chart *

parent = 0

)

Definition at line 53 of file KDChartHeaderFooter.cpp.

References setParent().

Referenced by clone().

HeaderFooter::~HeaderFooter ( )

virtual

Definition at line 60 of file KDChartHeaderFooter.cpp.

References destroyedHeaderFooter().

Member Function Documentation

void AbstractAreaBase::alignToReferencePoint ( const RelativePosition &  position )

inherited

Definition at line 81 of file KDChartAbstractAreaBase.cpp.

QRect TextArea::areaGeometry ( ) const

protectedvirtualinherited

Implements KDChart::AbstractAreaBase.

Definition at line 102 of file KDChartTextArea.cpp.

References KDChart::TextLayoutItem::geometry().

Referenced by KDChart::TextArea::paintAll().

const QObject * KDChart::TextLayoutItem::autoReferenceArea ( ) const

inherited

Definition at line 239 of file KDChartLayoutItems.cpp.

Referenced by compare(), and 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().

HeaderFooter * HeaderFooter::clone ( ) const

virtual

Creates an exact copy of this header/footer.

Definition at line 93 of file KDChartHeaderFooter.cpp.

References d, HeaderFooter(), position(), setPosition(), KDChart::TextLayoutItem::setText(), KDChart::TextLayoutItem::setTextAttributes(), setType(), KDChart::TextLayoutItem::text(), KDChart::TextLayoutItem::textAttributes(), and type().

bool HeaderFooter::compare

(

const HeaderFooter &

other

)

const

Definition at line 103 of file KDChartHeaderFooter.cpp.

References KDChart::TextLayoutItem::autoReferenceArea(), position(), KDChart::TextLayoutItem::text(), KDChart::TextLayoutItem::textAttributes(), and type().

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().

void KDChart::HeaderFooter::destroyedHeaderFooter ( HeaderFooter *  )

signal

Referenced by ~HeaderFooter().

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

virtualinherited

pure virtual in QLayoutItem

Definition at line 298 of file KDChartLayoutItems.cpp.

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

virtualinherited

pure virtual in QLayoutItem

Definition at line 303 of file KDChartLayoutItems.cpp.

Referenced by KDChart::TextArea::areaGeometry(), KDChart::TextArea::paintAll(), and KDChart::TextArea::paintIntoRect().

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 KDChart::TextArea::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(), and KDChart::TextAttributes::rotation().

bool KDChart::TextLayoutItem::isEmpty ( ) const

virtualinherited

pure virtual in QLayoutItem

Definition at line 308 of file KDChartLayoutItems.cpp.

int KDChart::TextLayoutItem::marginWidth ( ) const

virtualinherited

Definition at line 479 of file KDChartLayoutItems.cpp.

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

QSize KDChart::TextLayoutItem::maximumSize ( ) const

virtualinherited

pure virtual in QLayoutItem

Definition at line 313 of file KDChartLayoutItems.cpp.

QSize KDChart::TextLayoutItem::minimumSize ( ) const

virtualinherited

pure virtual in QLayoutItem

Definition at line 318 of file KDChartLayoutItems.cpp.

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

virtualinherited

Implements KDChart::AbstractLayoutItem.

Definition at line 522 of file KDChartLayoutItems.cpp.

References fitFontSizeToGeometry(), and KDChart::PrintingParameters::scalePen().

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

void TextArea::paintAll ( QPainter &  painter )

virtualinherited

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 KDChart::TextArea::areaGeometry(), KDChart::TextLayoutItem::geometry(), KDChart::AbstractAreaBase::innerRect(), KDChart::TextLayoutItem::paint(), KDChart::AbstractAreaBase::paintBackground(), KDChart::AbstractAreaBase::paintFrame(), and KDChart::TextLayoutItem::setGeometry().

Referenced by KDChart::TextArea::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(), KDChart::TextArea::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 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::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(), KDChart::TextArea::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 KDChart::AbstractAreaBase::paintFrame().

void TextArea::paintIntoRect ( QPainter &  painter, const QRect &  rect  )

virtualinherited

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(), KDChart::TextArea::paintAll(), and KDChart::TextLayoutItem::setGeometry().

QLayout* KDChart::AbstractLayoutItem::parentLayout ( )

inherited

Definition at line 78 of file KDChartLayoutItems.h.

Position HeaderFooter::position

(

)

const

Definition at line 134 of file KDChartHeaderFooter.cpp.

References d.

Referenced by KDChart::Chart::addHeaderFooter(), clone(), compare(), and setPosition().

void KDChart::HeaderFooter::positionChanged ( HeaderFooter *  )

signal

Referenced by setPosition(), and setType().

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

signalinherited

Referenced by KDChart::TextArea::positionHasChanged().

void TextArea::positionHasChanged ( )

protectedvirtualinherited

Reimplemented from KDChart::AbstractAreaBase.

Definition at line 107 of file KDChartTextArea.cpp.

References KDChart::TextArea::positionChanged().

QFont KDChart::TextLayoutItem::realFont ( ) const

virtualinherited

Definition at line 386 of file KDChartLayoutItems.cpp.

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

qreal KDChart::TextLayoutItem::realFontSize ( ) const

virtualinherited

Definition at line 369 of file KDChartLayoutItems.cpp.

void KDChart::AbstractLayoutItem::removeFromParentLayout ( )

inherited

Definition at line 82 of file KDChartLayoutItems.h.

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

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

inherited

Definition at line 232 of file KDChartLayoutItems.cpp.

Referenced by 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().

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

virtualinherited

pure virtual in QLayoutItem

Definition at line 323 of file KDChartLayoutItems.cpp.

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

void HeaderFooter::setParent

(

QObject *

parent

)

Definition at line 65 of file KDChartHeaderFooter.cpp.

References KDChart::TextLayoutItem::autoReferenceArea(), KDChart::TextLayoutItem::setAutoReferenceArea(), and KDChart::AbstractLayoutItem::setParentWidget().

Referenced by KDChart::Widget::addHeaderFooter(), HeaderFooter(), and KDChart::Widget::replaceHeaderFooter().

void KDChart::AbstractLayoutItem::setParentLayout ( QLayout *  lay )

inherited

Definition at line 74 of file KDChartLayoutItems.h.

Referenced by KDChart::Chart::addHeaderFooter(), 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 setParent(), and KDChart::AbstractCartesianDiagram::takeAxis().

void HeaderFooter::setPosition

(

Position

position

)

Definition at line 126 of file KDChartHeaderFooter.cpp.

References d, position(), and positionChanged().

Referenced by KDChart::Widget::addHeaderFooter(), and clone().

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

inherited

Definition at line 244 of file KDChartLayoutItems.cpp.

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

void KDChart::TextLayoutItem::setTextAlignment ( Qt::Alignment  alignment )

inherited

Definition at line 258 of file KDChartLayoutItems.cpp.

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().

Referenced by KDChart::Chart::addHeaderFooter(), clone(), and KDChart::CartesianAxis::paintCtx().

void HeaderFooter::setType

(

HeaderFooterType

type

)

Definition at line 113 of file KDChartHeaderFooter.cpp.

References d, positionChanged(), and type().

Referenced by KDChart::Widget::addHeaderFooter(), and clone().

QSize KDChart::TextLayoutItem::sizeHint ( ) const

virtualinherited

pure virtual in QLayoutItem

Definition at line 443 of file KDChartLayoutItems.cpp.

Referenced by KDChart::LeveyJenningsAxis::paintAsAbscissa(), and KDChart::CartesianAxis::paintCtx().

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.

QSize KDChart::TextLayoutItem::sizeHintUnrotated ( ) const

virtualinherited

Definition at line 457 of file KDChartLayoutItems.cpp.

QString KDChart::TextLayoutItem::text ( ) const

inherited

Definition at line 253 of file KDChartLayoutItems.cpp.

Referenced by clone(), and compare().

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(), clone(), and compare().

HeaderFooter::HeaderFooterType HeaderFooter::type

(

)

const

Definition at line 121 of file KDChartHeaderFooter.cpp.

References d.

Referenced by KDChart::Chart::addHeaderFooter(), clone(), compare(), and setType().

Member Data Documentation

QWidget* KDChart::AbstractLayoutItem::mParent

protectedinherited

Definition at line 92 of file KDChartLayoutItems.h.

Referenced by KDChart::AbstractLayoutItem::setParentWidget().

QLayout* KDChart::AbstractLayoutItem::mParentLayout

protectedinherited

Definition at line 93 of file KDChartLayoutItems.h.

---

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

• KDChartHeaderFooter.h
• KDChartHeaderFooter.cpp