KD Chart 2  [rev.2.7]
Signals | Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
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:
Inheritance graph
[legend]
Collaboration diagram for KDChart::TextArea:
Collaboration graph
[legend]

Signals

void positionChanged (TextArea *)
 

Public Member Functions

void alignToReferencePoint (const RelativePosition &position)
 
const QObjectautoReferenceArea () 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 QPoint &myPos, const QPoint &otherPos) const
 
virtual bool intersects (const TextLayoutItem &other, const QPointF &myPos, const QPointF &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

QWidgetmParent
 
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::~TextArea ( )
override

Definition at line 57 of file KDChartTextArea.cpp.

◆ TextArea()

TextArea::TextArea ( )
protected

Definition at line 49 of file KDChartTextArea.cpp.

Member Function Documentation

◆ alignToReferencePoint()

void AbstractAreaBase::alignToReferencePoint ( const RelativePosition position)
inherited

Definition at line 81 of file KDChartAbstractAreaBase.cpp.

◆ areaGeometry()

QRect TextArea::areaGeometry ( ) const
overrideprotectedvirtual

Implements KDChart::AbstractAreaBase.

Definition at line 102 of file KDChartTextArea.cpp.

References KDChart::TextLayoutItem::geometry().

Referenced by paintAll().

◆ autoReferenceArea()

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

◆ backgroundAttributes()

BackgroundAttributes AbstractAreaBase::backgroundAttributes ( ) const
inherited

Definition at line 111 of file KDChartAbstractAreaBase.cpp.

References d.

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

◆ boundingPolygon()

QPolygon KDChart::TextLayoutItem::boundingPolygon ( ) const
inherited

◆ compare()

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

◆ expandingDirections()

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

pure virtual in QLayoutItem

Definition at line 298 of file KDChartLayoutItems.cpp.

◆ frameAttributes()

FrameAttributes AbstractAreaBase::frameAttributes ( ) const
inherited

◆ geometry()

QRect KDChart::TextLayoutItem::geometry ( ) const
overrideinherited

pure virtual in QLayoutItem

Definition at line 303 of file KDChartLayoutItems.cpp.

Referenced by areaGeometry(), paintAll(), and paintIntoRect().

◆ getFrameLeadings()

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

◆ innerRect()

QRect AbstractAreaBase::innerRect ( ) const
protectedinherited

◆ intersects() [1/2]

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

◆ intersects() [2/2]

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

◆ isEmpty()

bool KDChart::TextLayoutItem::isEmpty ( ) const
overrideinherited

pure virtual in QLayoutItem

Definition at line 308 of file KDChartLayoutItems.cpp.

◆ marginWidth()

int KDChart::TextLayoutItem::marginWidth ( ) const
virtualinherited

Definition at line 447 of file KDChartLayoutItems.cpp.

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

◆ maximumSize()

QSize KDChart::TextLayoutItem::maximumSize ( ) const
overrideinherited

pure virtual in QLayoutItem

Definition at line 313 of file KDChartLayoutItems.cpp.

◆ minimumSize()

QSize KDChart::TextLayoutItem::minimumSize ( ) const
overrideinherited

pure virtual in QLayoutItem

Definition at line 318 of file KDChartLayoutItems.cpp.

◆ paint()

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

◆ paintAll()

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

◆ paintBackground()

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

◆ paintBackgroundAttributes()

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

◆ paintCtx()

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

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

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

Definition at line 72 of file KDChartLayoutItems.cpp.

References KDChart::PaintContext::painter().

◆ paintFrame()

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

◆ paintFrameAttributes()

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

◆ paintIntoRect()

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

◆ parentLayout()

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

Definition at line 77 of file KDChartLayoutItems.h.

◆ positionChanged

void KDChart::TextArea::positionChanged ( TextArea )
signal

Referenced by positionHasChanged().

◆ positionHasChanged()

void TextArea::positionHasChanged ( )
overrideprotectedvirtual

Reimplemented from KDChart::AbstractAreaBase.

Definition at line 107 of file KDChartTextArea.cpp.

References positionChanged().

◆ realFont()

QFont KDChart::TextLayoutItem::realFont ( ) const
virtualinherited

Definition at line 386 of file KDChartLayoutItems.cpp.

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

◆ realFontSize()

qreal KDChart::TextLayoutItem::realFontSize ( ) const
virtualinherited

Definition at line 369 of file KDChartLayoutItems.cpp.

◆ removeFromParentLayout()

void KDChart::AbstractLayoutItem::removeFromParentLayout ( )
inherited

◆ setAutoReferenceArea()

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

Definition at line 232 of file KDChartLayoutItems.cpp.

Referenced by KDChart::HeaderFooter::setParent().

◆ setBackgroundAttributes()

void AbstractAreaBase::setBackgroundAttributes ( const BackgroundAttributes a)
inherited

◆ setFrameAttributes()

void AbstractAreaBase::setFrameAttributes ( const FrameAttributes a)
inherited

◆ setGeometry()

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

◆ setParentLayout()

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

◆ setParentWidget()

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(), and KDChart::AbstractCartesianDiagram::takeAxis().

◆ setText()

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

◆ setTextAlignment()

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

Definition at line 258 of file KDChartLayoutItems.cpp.

◆ setTextAttributes()

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(), KDChart::HeaderFooter::clone(), and KDChart::CartesianAxis::paintCtx().

◆ sizeHint()

QSize KDChart::TextLayoutItem::sizeHint ( ) const
overrideinherited

◆ sizeHintChanged()

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.

◆ sizeHintUnrotated()

QSize KDChart::TextLayoutItem::sizeHintUnrotated ( ) const
virtualinherited

Definition at line 425 of file KDChartLayoutItems.cpp.

◆ text()

QString KDChart::TextLayoutItem::text ( ) const
inherited

◆ textAlignment()

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

Definition at line 267 of file KDChartLayoutItems.cpp.

◆ textAttributes()

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(), and KDChart::HeaderFooter::compare().

Member Data Documentation

◆ mParent

QWidget* KDChart::AbstractLayoutItem::mParent
protectedinherited

Definition at line 91 of file KDChartLayoutItems.h.

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

◆ mParentLayout

QLayout* KDChart::AbstractLayoutItem::mParentLayout
protectedinherited

Definition at line 92 of file KDChartLayoutItems.h.


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

Klarälvdalens Datakonsult AB (KDAB)
"The Qt, C++ and OpenGL Experts"
https://www.kdab.com/

https://www.kdab.com/development-resources/qt-tools/kd-chart/