KDChart::Legend Class Reference

#include <KDChartLegend.h>

Inheritance diagram for KDChart::Legend:

[legend]

Collaboration diagram for KDChart::Legend:

[legend]

List of all members.

---

Detailed Description

Legend defines the interface for the legend drawing class.

Legend is the class for drawing legends for all kinds of diagrams ("chart types").

Legend is drawn on chart level, not per diagram, but you can have more than one legend per chart, using KDChart::Chart::addLegend().

Note:

Legend is different from all other classes ofd KD Chart, since it can be displayed outside of the Chart's area. If you want to, you can embedd the legend into your own widget, or into another part of a bigger grid, into which you might have inserted the Chart.

On the other hand, please note that you MUST call Chart::addLegend to get your legend positioned into the correct place of your chart - if you want to have the legend shown inside of the chart (that's probably true for most cases).

Definition at line 62 of file KDChartLegend.h.

Public Types
enum	LegendStyle {   MarkersOnly = 0,   LinesOnly = 1,   MarkersAndLines = 2 }
Signals
void	destroyedLegend (Legend *)
void	positionChanged (AbstractAreaWidget *)
void	propertiesChanged ()
	Emitted upon change of a property of the Legend or any of its components.
Public Member Functions
void	addDiagram (KDChart::AbstractDiagram *newDiagram)
	Add the given diagram to the legend.
Qt::Alignment	alignment () const
	Returns the alignment of a non-floating legend.
void	alignToReferencePoint (const RelativePosition &position)
BackgroundAttributes	backgroundAttributes () const
QBrush	brush (uint dataset) const
const QMap< uint, QBrush >	brushes () const
virtual Legend *	clone () const
	Creates an exact copy of this legend.
bool	compare (const AbstractAreaBase *other) const
	Returns true if both areas have the same settings.
bool	compare (const Legend *other) const
	Returns true if both legends have the same settings.
ConstDiagramList	constDiagrams () const
	Returns: The list of diagrams associated with this coordinate plane.
uint	datasetCount () const
bool	datasetIsHidden (uint dataset) const
uint	dataSetOffset (KDChart::AbstractDiagram *diagram)
	Returns the offset of the first dataset of diagram.
KDChart::AbstractDiagram *	diagram () const
	The first diagram of the legend or 0 if there was none added to the legend.
DiagramList	diagrams () const
	The list of all diagrams associated with the legend.
const RelativePosition	floatingPosition () const
	Returns the position of a floating legend.
virtual void	forceRebuild ()
	Call this to trigger an unconditional re-building of the widget's internals.
FrameAttributes	frameAttributes () const
void	getFrameLeadings (int &left, int &top, int &right, int &bottom) const
const QList< uint >	hiddenDatasets () const
	Legend (KDChart::AbstractDiagram *diagram, QWidget *parent)
	Legend (QWidget *parent=0)
LegendStyle	legendStyle () const
const QMap< uint, MarkerAttributes >	markerAttributes () const
MarkerAttributes	markerAttributes (uint dataset) const
virtual QSize	minimumSizeHint () const
virtual void	needSizeHint ()
	Call this to trigger an conditional re-building of the widget's internals.
Qt::Orientation	orientation () const
virtual void	paint (QPainter *painter)
	Overwrite this to paint the inner contents of your widget.
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	paintEvent (QPaintEvent *event)
	Draws the background and frame, then calls paint().
virtual void	paintFrame (QPainter &painter, const QRect &rectangle)
virtual void	paintIntoRect (QPainter &painter, const QRect &rect)
	Draws the background and frame, then calls paint().
QPen	pen (uint dataset) const
const QMap< uint, QPen >	pens () const
Position	position () const
	Returns the position of a non-floating legend.
const QWidget *	referenceArea () const
	Returns the reference area, that is used for font size of title text, and for font size of the item texts, IF automatic area detection is set.
void	removeDiagram (KDChart::AbstractDiagram *oldDiagram)
	Removes the diagram from the legend's list of diagrams.
void	removeDiagrams ()
	Removes all of the diagram from the legend's list of diagrams.
void	replaceDiagram (KDChart::AbstractDiagram *newDiagram, KDChart::AbstractDiagram *oldDiagram=0)
	Replaces the old diagram, or appends the new diagram, it there is none yet.
void	resetTexts ()
	Removes all legend texts that might have been set by setText.
virtual void	resizeEvent (QResizeEvent *event)
virtual void	resizeLayout (const QSize &size)
void	setAlignment (Qt::Alignment)
	Specify the alignment of a non-floating legend.
void	setBackgroundAttributes (const BackgroundAttributes &a)
void	setBrush (uint dataset, const QBrush &brush)
void	setBrushesFromDiagram (KDChart::AbstractDiagram *diagram)
void	setColor (uint dataset, const QColor &color)
	Note: there is no color() getter method, since setColor just sets a QBrush with the respective color, so the brush() getter method is sufficient.
void	setDatasetHidden (uint dataset, bool hidden)
void	setDefaultColors ()
void	setDiagram (KDChart::AbstractDiagram *newDiagram)
	A convenience method doing the same as replaceDiagram( newDiagram, 0 );.
void	setFloatingPosition (const RelativePosition &relativePosition)
	Specify the position and alignment of a floating legend.
void	setFrameAttributes (const FrameAttributes &a)
void	setHiddenDatasets (const QList< uint > hiddenDatasets)
	Sets a list of datasets that are to be hidden in the legend.
void	setLegendStyle (LegendStyle style)
void	setMarkerAttributes (uint dataset, const MarkerAttributes &)
	Note that any sizes specified via setMarkerAttributes are ignored, unless you disable the automatic size calculation, by saying setUseAutomaticMarkerSize( false ).
void	setOrientation (Qt::Orientation orientation)
void	setPen (uint dataset, const QPen &pen)
void	setPosition (Position position)
	Specify the position of a non-floating legend.
void	setRainbowColors ()
void	setReferenceArea (const QWidget *area)
	Specifies the reference area for font size of title text, and for font size of the item texts, IF automatic area detection is set.
void	setShowLines (bool legendShowLines)
void	setSortOrder (Qt::SortOrder order)
void	setSpacing (uint space)
void	setSubduedColors (bool ordered=false)
void	setText (uint dataset, const QString &text)
void	setTextAlignment (Qt::Alignment)
	Specify the alignment of the text elements within the legend.
void	setTextAttributes (const TextAttributes &a)
void	setTitleText (const QString &text)
void	setTitleTextAttributes (const TextAttributes &a)
void	setUseAutomaticMarkerSize (bool useAutomaticMarkerSize)
	This option is on by default, it means that Marker sizes in the Legend will be the same as the font height used for their respective label texts.
virtual void	setVisible (bool visible)
bool	showLines () const
virtual QSize	sizeHint () const
Qt::SortOrder	sortOrder () const
uint	spacing () const
QString	text (uint dataset) const
Qt::Alignment	textAlignment () const
	Returns the alignment used while rendering text elements within the legend.
TextAttributes	textAttributes () const
const QMap< uint, QString >	texts () const
QString	titleText () const
TextAttributes	titleTextAttributes () const
bool	useAutomaticMarkerSize () const
virtual	~Legend ()
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 ()

---

Member Enumeration Documentation

enum KDChart::Legend::LegendStyle

Enumerator:

MarkersOnly
LinesOnly
MarkersAndLines

Definition at line 75 of file KDChartLegend.h.

                     { MarkersOnly     = 0,
                       LinesOnly       = 1,
                       MarkersAndLines = 2 };

---

Constructor & Destructor Documentation

Legend::Legend

(

QWidget *

parent = 0

)

[explicit]

Definition at line 87 of file KDChartLegend.cpp.

References d, and StockDiagram::init().

Referenced by clone().

                                :
    AbstractAreaWidget( new Private(), parent )
{
    d->referenceArea = parent;
    init();
}

Legend::Legend	(	KDChart::AbstractDiagram *	diagram,
		QWidget *	parent
	)			[explicit]

Definition at line 94 of file KDChartLegend.cpp.

References d, StockDiagram::init(), and setDiagram().

                                                                 :
    AbstractAreaWidget( new Private(), parent )
{
    d->referenceArea = parent;
    init();
    setDiagram( diagram );
}

Legend::~Legend

(

)

[virtual]

Definition at line 102 of file KDChartLegend.cpp.

References destroyedLegend().

{
    emit destroyedLegend( this );
}

---

Member Function Documentation

void Legend::addDiagram

(

KDChart::AbstractDiagram *

newDiagram

)

Add the given diagram to the legend.

Parameters:

newDiagram

The diagram to add.

See also:

diagram, diagrams, removeDiagram, removeDiagrams, replaceDiagram, setDiagram

Definition at line 342 of file KDChartLegend.cpp.

References d.

Referenced by replaceDiagram().

{
    if ( newDiagram )
    {
        DiagramObserver* observer = new DiagramObserver( newDiagram, this );

        DiagramObserver* oldObs = d->findObserverForDiagram( newDiagram );
        if( oldObs ){
            delete oldObs;
            d->observers[ d->observers.indexOf( oldObs ) ] = observer;
        }else{
            d->observers.append( observer );
        }
        connect( observer, SIGNAL( diagramDestroyed(AbstractDiagram*) ),
                        SLOT( resetDiagram(AbstractDiagram*) ));
        connect( observer, SIGNAL( diagramDataChanged(AbstractDiagram*) ),
                 SLOT( setNeedRebuild() ));
        connect( observer, SIGNAL( diagramDataHidden(AbstractDiagram*) ),
                 SLOT( setNeedRebuild() ));
        connect( observer, SIGNAL( diagramAttributesChanged(AbstractDiagram*) ),
                        SLOT( setNeedRebuild() ));
        setNeedRebuild();
    }
}

Qt::Alignment Legend::alignment

(

)

const

Returns the alignment of a non-floating legend.

See also:

setAlignment

Definition at line 476 of file KDChartLegend.cpp.

References d.

Referenced by clone(), and compare().

{
    return d->alignment;
}

void AbstractAreaBase::alignToReferencePoint

(

const RelativePosition &

position

)

[inherited]

Definition at line 91 of file KDChartAbstractAreaBase.cpp.

{
    Q_UNUSED( position );
    // PENDING(kalle) FIXME
    qWarning( "Sorry, not implemented: void AbstractAreaBase::alignToReferencePoint( const RelativePosition& position )" );
}

QRect AbstractAreaWidget::areaGeometry

(

)

const [protected, virtual, inherited]

Implements KDChart::AbstractAreaBase.

Definition at line 186 of file KDChartAbstractAreaWidget.cpp.

{
    return geometry();
}

BackgroundAttributes AbstractAreaBase::backgroundAttributes

(

)

const [inherited]

Definition at line 121 of file KDChartAbstractAreaBase.cpp.

References d.

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

{
    return d->backgroundAttributes;
}

QBrush Legend::brush

(

uint

dataset

)

const

Definition at line 609 of file KDChartLegend.cpp.

References d.

Referenced by setRainbowColors().

{
    if( d->brushes.find( dataset ) != d->brushes.end() )
        return d->brushes[ dataset ];
    else
        return d->modelBrushes[ dataset ];
}

const QMap< uint, QBrush > Legend::brushes

(

)

const

Definition at line 617 of file KDChartLegend.cpp.

References d.

Referenced by compare().

{
    return d->brushes;
}

Legend * Legend::clone

(

)

const [virtual]

Creates an exact copy of this legend.

Definition at line 206 of file KDChartLegend.cpp.

References alignment(), d, KDChart::AbstractAreaBase::frameAttributes(), Legend(), legendStyle(), position(), StockDiagram::Private::Private(), setAlignment(), KDChart::AbstractAreaBase::setFrameAttributes(), setLegendStyle(), setPosition(), setTextAlignment(), setTextAttributes(), setTitleTextAttributes(), setUseAutomaticMarkerSize(), textAlignment(), textAttributes(), titleTextAttributes(), and useAutomaticMarkerSize().

{
    Legend* legend = new Legend( new Private( *d ), 0 );
    legend->setTextAttributes( textAttributes() );
    legend->setTitleTextAttributes( titleTextAttributes() );
    legend->setFrameAttributes( frameAttributes() );
    legend->setUseAutomaticMarkerSize( useAutomaticMarkerSize() );
    legend->setPosition( position() );
    legend->setAlignment( alignment() );
    legend->setTextAlignment( textAlignment() );
    legend->setLegendStyle( legendStyle() );
    return legend;
}

bool AbstractAreaBase::compare

(

const AbstractAreaBase *

other

)

const [inherited]

Returns true if both areas have the same settings.

Definition at line 76 of file KDChartAbstractAreaBase.cpp.

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

{
    if( other == this ) return true;
    if( ! other ){
        //qDebug() << "CartesianAxis::compare() cannot compare to Null pointer";
        return false;
    }
    /*
    qDebug() << "AbstractAreaBase:" << (frameAttributes() == other->frameAttributes())
        << (backgroundAttributes() == other->backgroundAttributes()) << "\n";
    */
    return  (frameAttributes()      == other->frameAttributes()) &&
            (backgroundAttributes() == other->backgroundAttributes());
}

bool Legend::compare

(

const Legend *

other

)

const

Returns true if both legends have the same settings.

Definition at line 221 of file KDChartLegend.cpp.

References alignment(), brushes(), floatingPosition(), legendStyle(), markerAttributes(), orientation(), pens(), position(), showLines(), spacing(), textAlignment(), textAttributes(), texts(), titleText(), titleTextAttributes(), and useAutomaticMarkerSize().

{
    if( other == this ) return true;
    if( ! other ){
        //qDebug() << "Legend::compare() cannot compare to Null pointer";
        return false;
    }

    qDebug() << ( static_cast<const AbstractAreaBase*>(this)->compare( other ) );
    qDebug() << (isVisible()              == other->isVisible());
    qDebug() << (position()               == other->position());
    qDebug() << (alignment()              == other->alignment());
    qDebug() << (textAlignment()          == other->textAlignment());
    qDebug() << (floatingPosition()       == other->floatingPosition());
    qDebug() << (orientation()            == other->orientation());
    qDebug() << (showLines()              == other->showLines());
    qDebug() << (texts()                  == other->texts());
    qDebug() << (brushes()                == other->brushes());
    qDebug() << (pens()                   == other->pens());
    qDebug() << (markerAttributes()       == other->markerAttributes());
    qDebug() << (useAutomaticMarkerSize() == other->useAutomaticMarkerSize());
    qDebug() << (textAttributes()         == other->textAttributes());
    qDebug() << (titleText()              == other->titleText());
    qDebug() << (titleTextAttributes()    == other->titleTextAttributes());
    qDebug() << (spacing()                == other->spacing());
    qDebug() << (legendStyle()            == other->legendStyle());

    return  ( static_cast<const AbstractAreaBase*>(this)->compare( other ) ) &&
            (isVisible()              == other->isVisible()) &&
            (position()               == other->position()) &&
            (alignment()              == other->alignment())&&
            (textAlignment()          == other->textAlignment())&&
            (floatingPosition()       == other->floatingPosition()) &&
            (orientation()            == other->orientation())&&
            (showLines()              == other->showLines())&&
            (texts()                  == other->texts())&&
            (brushes()                == other->brushes())&&
            (pens()                   == other->pens())&&
            (markerAttributes()       == other->markerAttributes())&&
            (useAutomaticMarkerSize() == other->useAutomaticMarkerSize()) &&
            (textAttributes()         == other->textAttributes()) &&
            (titleText()              == other->titleText())&&
            (titleTextAttributes()    == other->titleTextAttributes()) &&
            (spacing()                == other->spacing()) &&
            (legendStyle()            == other->legendStyle());
}

ConstDiagramList Legend::constDiagrams

(

)

const

Returns:

The list of diagrams associated with this coordinate plane.

Definition at line 334 of file KDChartLegend.cpp.

References d.

{
    ConstDiagramList list;
    for (int i = 0; i < d->observers.size(); ++i)
        list << d->observers.at(i)->diagram();
    return list;
}

uint Legend::datasetCount

(

)

const

Definition at line 291 of file KDChartLegend.cpp.

References d, KDChart::AbstractDiagram::datasetBrushes(), KDChart::AbstractDiagram::datasetLabels(), and KDChart::DiagramObserver::diagram().

{
    int modelLabelsCount = 0;
    int modelBrushesCount = 0;
    for (int i = 0; i < d->observers.size(); ++i) {
        DiagramObserver * obs = d->observers.at(i);
        modelLabelsCount  += obs->diagram()->datasetLabels().count();
        modelBrushesCount += obs->diagram()->datasetBrushes().count();
    }
    Q_ASSERT( modelLabelsCount == modelBrushesCount );
    return modelLabelsCount;
}

bool Legend::datasetIsHidden

(

uint

dataset

)

const

Definition at line 1124 of file KDChartLegend.cpp.

References d.

{
    return d->hiddenDatasets.contains( dataset );
}

uint Legend::dataSetOffset

(

KDChart::AbstractDiagram *

diagram

)

Returns the offset of the first dataset of diagram.

Definition at line 403 of file KDChartLegend.cpp.

References d.

{
    uint offset = 0;

    for (int i = 0; i < d->observers.count(); ++i)
    {
        if(d->observers.at(i)->diagram() == diagram)
            return offset;

        KDChart::AbstractDiagram* diagram = d->observers.at(i)->diagram();
        if(!diagram->model())
            continue;

        offset = offset + diagram->model()->columnCount();
    }

    return offset;
}

void KDChart::Legend::destroyedLegend

(

Legend *

)

[signal]

Referenced by ~Legend().

AbstractDiagram * Legend::diagram

(

)

const

The first diagram of the legend or 0 if there was none added to the legend.

Returns:

The first diagram of the legend or 0.

See also:

diagrams, addDiagram, removeDiagram, removeDiagrams, replaceDiagram, setDiagram

Definition at line 319 of file KDChartLegend.cpp.

References d.

Referenced by paint().

{
    if( d->observers.isEmpty() )
        return 0;
    return d->observers.first()->diagram();
}

DiagramList Legend::diagrams

(

)

const

The list of all diagrams associated with the legend.

Returns:

The list of all diagrams associated with the legend.

See also:

diagram, addDiagram, removeDiagram, removeDiagrams, replaceDiagram, setDiagram

Definition at line 326 of file KDChartLegend.cpp.

References d.

{
    DiagramList list;
    for (int i = 0; i < d->observers.size(); ++i)
        list << d->observers.at(i)->diagram();
    return list;
}

const RelativePosition Legend::floatingPosition

(

)

const

Returns the position of a floating legend.

See also:

setFloatingPosition

Definition at line 503 of file KDChartLegend.cpp.

References d.

Referenced by compare(), and KDChart::Chart::reLayoutFloatingLegends().

{
    return d->relativePosition;
}

void Legend::forceRebuild

(

)

[virtual]

Call this to trigger an unconditional re-building of the widget's internals.

Reimplemented from KDChart::AbstractAreaWidget.

Definition at line 721 of file KDChartLegend.cpp.

Referenced by resizeEvent().

{
#ifdef DEBUG_LEGEND_PAINT
    qDebug() << "entering Legend::forceRebuild()";
#endif
    //setSpacing(d->layout->spacing());
    buildLegend();
#ifdef DEBUG_LEGEND_PAINT
    qDebug() << "leaving Legend::forceRebuild()";
#endif
}

FrameAttributes AbstractAreaBase::frameAttributes

(

)

const [inherited]

Definition at line 107 of file KDChartAbstractAreaBase.cpp.

References d.

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

{
    return d->frameAttributes;
}

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

{
    if( d && d->frameAttributes.isVisible() ){
        const int padding = qMax( d->frameAttributes.padding(), 0 );
        left   = padding;
        top    = padding;
        right  = padding;
        bottom = padding;
    }else{
        left   = 0;
        top    = 0;
        right  = 0;
        bottom = 0;
    }
}

const QList< uint > Legend::hiddenDatasets

(

)

const

Definition at line 1111 of file KDChartLegend.cpp.

References d.

{
    return d->hiddenDatasets;
}

QRect AbstractAreaBase::innerRect

(

)

const [protected, inherited]

Definition at line 229 of file KDChartAbstractAreaBase.cpp.

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

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

{
    int left;
    int top;
    int right;
    int bottom;
    getFrameLeadings( left, top, right, bottom );
    return
        QRect( QPoint(0,0), areaGeometry().size() )
            .adjusted( left, top, -right, -bottom );
}

Legend::LegendStyle Legend::legendStyle

(

)

const

Definition at line 198 of file KDChartLegend.cpp.

References d.

Referenced by clone(), and compare().

{
    return d->legendStyle;
}

const QMap< uint, MarkerAttributes > Legend::markerAttributes

(

)

const

Definition at line 679 of file KDChartLegend.cpp.

References d.

Referenced by compare().

{
    return d->markerAttributes;
}

MarkerAttributes Legend::markerAttributes

(

uint

dataset

)

const

Definition at line 670 of file KDChartLegend.cpp.

References d.

Referenced by compare().

{
    if( d->markerAttributes.find( dataset ) != d->markerAttributes.end() )
        return d->markerAttributes[ dataset ];
    else if ( static_cast<uint>( d->modelMarkers.count() ) > dataset )
        return d->modelMarkers[ dataset ];
    return MarkerAttributes();
}

QSize Legend::minimumSizeHint

(

)

const [virtual]

Definition at line 145 of file KDChartLegend.cpp.

References sizeHint().

{
    return sizeHint();
}

void Legend::needSizeHint

(

)

[virtual]

Call this to trigger an conditional re-building of the widget's internals.

e.g. AbstractAreaWidget call this, before calling layout()->setGeometry()

Reimplemented from KDChart::AbstractAreaWidget.

Definition at line 163 of file KDChartLegend.cpp.

{
    // Re-build the Legend's content, if it has not been build yet,
    // or if the Legend's geometry has changed, resp.
    buildLegend();
}

Qt::Orientation Legend::orientation

(

)

const

Definition at line 516 of file KDChartLegend.cpp.

References d.

Referenced by compare().

{
    return d->orientation;
}

void Legend::paint

(

QPainter *

painter

)

[virtual]

Overwrite this to paint the inner contents of your widget.

Note:

When overriding this method, please let your widget draw itself at the top/left corner of the painter. You should call rect() (or width(), height(), resp.) to find the drawable area's size: While the paint() method is being executed the frame of the widget is outside of its rect(), so you can use all of rect() for your custom drawing!

See also:

paint, paintIntoRect

Implements KDChart::AbstractAreaWidget.

Definition at line 269 of file KDChartLegend.cpp.

References d, diagram(), and KDChart::AbstractLayoutItem::paint().

{
#ifdef DEBUG_LEGEND_PAINT
    qDebug() << "entering Legend::paint( QPainter* painter )";
#endif
    // rule: We do not show a legend, if there is no diagram.
    if( ! diagram() ) return;

    // re-calculate/adjust the Legend's internal layout and contents, if needed:
    //buildLegend();

    // PENDING(kalle) Support palette

    Q_FOREACH( KDChart::AbstractLayoutItem* layoutItem, d->layoutItems ) {
        layoutItem->paint( painter );
    }
#ifdef DEBUG_LEGEND_PAINT
    qDebug() << "leaving Legend::paint( QPainter* painter )";
#endif
}

void AbstractAreaWidget::paintAll

(

QPainter &

painter

)

[inherited]

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

Definition at line 145 of file KDChartAbstractAreaWidget.cpp.

References KDChart::AbstractAreaBase::getFrameLeadings(), KDChart::AbstractAreaWidget::paint(), KDChart::AbstractAreaBase::paintBackground(), and KDChart::AbstractAreaBase::paintFrame().

Referenced by KDChart::AbstractAreaWidget::paintEvent(), and KDChart::AbstractAreaWidget::paintIntoRect().

{
    //qDebug() << "AbstractAreaWidget::paintAll() called";

    // Paint the background and frame
    paintBackground( painter, QRect(QPoint(0, 0), size() ) );
    paintFrame(      painter, QRect(QPoint(0, 0), size() ) );

/*
    we do not call setContentsMargins() now,
    but we call resizeLayout() whenever the size or the frame has changed

    // adjust the widget's content margins,
    // to be sure all content gets calculated
    // to fit into the inner rectangle
    const QRect oldGeometry( areaGeometry()  );
    const QRect inner( innerRect() );
    //qDebug() << "areaGeometry():" << oldGeometry
    //         << "  contentsRect():" << contentsRect() << "  inner:" << inner;
    if( contentsRect() != inner ){
        //qDebug() << "old contentsRect():" << contentsRect() << "  new innerRect:" << inner;
        setContentsMargins(
            inner.left(),
            inner.top(),
            oldGeometry.width() -inner.width()-1,
            oldGeometry.height()-inner.height()-1 );
        //forceRebuild();
    }
*/
    int left;
    int top;
    int right;
    int bottom;
    getFrameLeadings( left, top, right, bottom );
    const QPoint translation( left, top );
    painter.translate( translation );
    paint( &painter );
    painter.translate( -translation.x(), -translation.y() );
     //qDebug() << "AbstractAreaWidget::paintAll() done.";
}

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

Definition at line 197 of file KDChartAbstractAreaBase.cpp.

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

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

{
    Q_ASSERT_X ( d != 0, "AbstractAreaBase::paintBackground()",
                "Private class was not initialized!" );
    paintBackgroundAttributes( painter, rect, d->backgroundAttributes );
}

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

Definition at line 128 of file KDChartAbstractAreaBase.cpp.

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

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

{
    if( !attributes.isVisible() ) return;

    /* first draw the brush (may contain a pixmap)*/
    if( Qt::NoBrush != attributes.brush().style() ) {
        KDChart::PainterSaver painterSaver( &painter );
        painter.setPen( Qt::NoPen );
        const QPointF newTopLeft( painter.deviceMatrix().map( rect.topLeft() ) );
        painter.setBrushOrigin( newTopLeft );
        painter.setBrush( attributes.brush() );
        painter.drawRect( rect.adjusted( 0, 0, -1, -1 ) );
    }
    /* next draw the backPixmap over the brush */
    if( !attributes.pixmap().isNull() &&
        attributes.pixmapMode() != BackgroundAttributes::BackgroundPixmapModeNone ) {
        QPointF ol = rect.topLeft();
        if( BackgroundAttributes::BackgroundPixmapModeCentered == attributes.pixmapMode() )
        {
            ol.setX( rect.center().x() - attributes.pixmap().width() / 2 );
            ol.setY( rect.center().y() - attributes.pixmap().height()/ 2 );
            painter.drawPixmap( ol, attributes.pixmap() );
        } else {
            QMatrix m;
            double zW = (double)rect.width()  / (double)attributes.pixmap().width();
            double zH = (double)rect.height() / (double)attributes.pixmap().height();
            switch( attributes.pixmapMode() ) {
            case BackgroundAttributes::BackgroundPixmapModeScaled:
            {
                double z;
                z = qMin( zW, zH );
                m.scale( z, z );
            }
            break;
            case BackgroundAttributes::BackgroundPixmapModeStretched:
                m.scale( zW, zH );
                break;
            default:
                ; // Cannot happen, previously checked
            }
            QPixmap pm = attributes.pixmap().transformed( m );
            ol.setX( rect.center().x() - pm.width() / 2 );
            ol.setY( rect.center().y() - pm.height()/ 2 );
            painter.drawPixmap( ol, pm );
        }
    }
}

void AbstractAreaWidget::paintEvent

(

QPaintEvent *

event

)

[virtual, inherited]

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

See also:

paint

Definition at line 99 of file KDChartAbstractAreaWidget.cpp.

References d, and KDChart::AbstractAreaWidget::paintAll().

{
    Q_UNUSED( event );
    QPainter painter( this );
    if( size() != d->currentLayoutSize ){
        d->resizeLayout( this, size() );
    }
    paintAll( painter );
}

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

Definition at line 205 of file KDChartAbstractAreaBase.cpp.

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

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

{
    Q_ASSERT_X ( d != 0, "AbstractAreaBase::paintFrame()",
                "Private class was not initialized!" );
    paintFrameAttributes( painter, rect, d->frameAttributes );
}

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

Definition at line 178 of file KDChartAbstractAreaBase.cpp.

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

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

{

    if( !attributes.isVisible() ) return;

    // Note: We set the brush to NoBrush explicitly here.
    //       Otherwise we might get a filled rectangle, so any
    //       previously drawn background would be overwritten by that area.

    const QPen   oldPen(   painter.pen() );
    const QBrush oldBrush( painter.brush() );
    painter.setPen(  PrintingParameters::scalePen( attributes.pen() ) );
    painter.setBrush( Qt::NoBrush );
    painter.drawRect( rect.adjusted( 0, 0, -1, -1 ) );
    painter.setBrush( oldBrush );
    painter.setPen( oldPen );
}

void AbstractAreaWidget::paintIntoRect	(	QPainter &	painter,
		const QRect &	rect
	)			[virtual, inherited]

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

Definition at line 109 of file KDChartAbstractAreaWidget.cpp.

References d, and KDChart::AbstractAreaWidget::paintAll().

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

{
    //qDebug() << "AbstractAreaWidget::paintIntoRect() called rect=" << rect;

    if( rect.isEmpty() ) return;

    d->resizeLayout( this, rect.size() );

    const QPoint translation( rect.topLeft() );
    painter.translate( translation );
    paintAll( painter );
    painter.translate( -translation.x(), -translation.y() );

/*
    // make sure, the contents of the widget have been set up,
    // so we get a useful geometry:
    needSizeHint();

    const QRect oldGeometry( layout()->geometry() );
    const QRect newGeo( QPoint(0,0), rect.size() );
    const bool mustChangeGeo = layout() && oldGeometry != newGeo;
    if( mustChangeGeo )
        layout()->setGeometry( newGeo );
    painter.translate( rect.left(), rect.top() );
    paintAll( painter );
    painter.translate( -rect.left(), -rect.top() );
    if( mustChangeGeo )
        layout()->setGeometry( oldGeometry );
*/
}

QPen Legend::pen

(

uint

dataset

)

const

Definition at line 648 of file KDChartLegend.cpp.

References d.

{
    if( d->pens.find( dataset ) != d->pens.end() )
        return d->pens[dataset];
    else
        return d->modelPens[ dataset ];
}

const QMap< uint, QPen > Legend::pens

(

)

const

Definition at line 656 of file KDChartLegend.cpp.

References d.

Referenced by compare().

{
    return d->pens;
}

Position Legend::position

(

)

const

Returns the position of a non-floating legend.

See also:

setPosition

Definition at line 463 of file KDChartLegend.cpp.

References d.

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

{
    return d->position;
}

void KDChart::AbstractAreaWidget::positionChanged

(

AbstractAreaWidget *

)

[signal, inherited]

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

void AbstractAreaWidget::positionHasChanged

(

)

[protected, virtual, inherited]

Reimplemented from KDChart::AbstractAreaBase.

Definition at line 191 of file KDChartAbstractAreaWidget.cpp.

References KDChart::AbstractAreaWidget::positionChanged().

{
    emit positionChanged( this );
}

void KDChart::Legend::propertiesChanged

(

)

[signal]

Emitted upon change of a property of the Legend or any of its components.

const QWidget * Legend::referenceArea

(

)

const

Returns the reference area, that is used for font size of title text, and for font size of the item texts, IF automatic area detection is set.

See also:

setReferenceArea

Definition at line 312 of file KDChartLegend.cpp.

References d.

{
    //qDebug() << d->referenceArea;
    return (d->referenceArea ? d->referenceArea : static_cast<const QWidget*>(parent()));
}

void Legend::removeDiagram

(

KDChart::AbstractDiagram *

oldDiagram

)

Removes the diagram from the legend's list of diagrams.

See also:

diagram, diagrams, addDiagram, removeDiagrams, replaceDiagram, setDiagram

Definition at line 367 of file KDChartLegend.cpp.

References d.

Referenced by removeDiagrams(), and replaceDiagram().

{
    if( oldDiagram ){
        DiagramObserver* oldObs = d->findObserverForDiagram( oldDiagram );
        if( oldObs ){
            //qDebug() << "before delete oldObs;";
            delete oldObs;
            //qDebug() << "after delete oldObs;";
            d->observers.removeAt( d->observers.indexOf( oldObs ) );
            //qDebug() << "after d->observers.removeAt()";
        }
        setNeedRebuild();
    }
}

void Legend::removeDiagrams

(

)

Removes all of the diagram from the legend's list of diagrams.

See also:

diagram, diagrams, addDiagram, removeDiagram, replaceDiagram, setDiagram

Definition at line 382 of file KDChartLegend.cpp.

References d, and removeDiagram().

{
    for (int i = 0; i < d->observers.size(); ++i)
        removeDiagram( d->observers.at(i)->diagram() );
}

void Legend::replaceDiagram	(	KDChart::AbstractDiagram *	newDiagram,
		KDChart::AbstractDiagram *	oldDiagram = 0
	)

Replaces the old diagram, or appends the new diagram, it there is none yet.

Parameters:

	newDiagram	The diagram to be used instead of the old one. If this parameter is zero, the first diagram will just be removed.
	oldDiagram	The diagram to be removed by the new one. This diagram will be deleted automatically. If the parameter is omitted, the very first diagram will be replaced. In case, there was no diagram yet, the new diagram will just be added.

See also:

diagram, diagrams, addDiagram, removeDiagram, removeDiagrams, setDiagram

Definition at line 388 of file KDChartLegend.cpp.

References addDiagram(), d, and removeDiagram().

Referenced by setDiagram().

{
    KDChart::AbstractDiagram* old = oldDiagram;
    if( ! d->observers.isEmpty() && ! old ){
        old = d->observers.first()->diagram();
        if( ! old )
            d->observers.removeFirst(); // first entry had a 0 diagram
    }
    if( old )
        removeDiagram( old );
    if( newDiagram )
        addDiagram( newDiagram );
}

void Legend::resetTexts

(

)

Removes all legend texts that might have been set by setText.

This resets the Legend to default behaviour: Texts are created automatically.

Definition at line 565 of file KDChartLegend.cpp.

References d.

{
    if( ! d->texts.count() ) return;
    d->texts.clear();
    setNeedRebuild();
}

void Legend::resizeEvent

(

QResizeEvent *

event

)

[virtual]

Definition at line 824 of file KDChartLegend.cpp.

References forceRebuild(), and sizeHint().

{
    Q_UNUSED( event );
#ifdef DEBUG_LEGEND_PAINT
    qDebug() << "Legend::resizeEvent() called";
#endif
    forceRebuild();
    sizeHint();
    QTimer::singleShot(0, this, SLOT(emitPositionChanged()));
}

void Legend::resizeLayout

(

const QSize &

size

)

[virtual]

Reimplemented from KDChart::AbstractAreaWidget.

Definition at line 170 of file KDChartLegend.cpp.

References d.

{
#ifdef DEBUG_LEGEND_PAINT
    qDebug() << "Legend::resizeLayout started";
#endif
    if( d->layout ){
        d->layout->setGeometry( QRect(QPoint(0,0), size) );
        activateTheLayout();
    }
#ifdef DEBUG_LEGEND_PAINT
    qDebug() << "Legend::resizeLayout done";
#endif
}

void Legend::setAlignment

(

Qt::Alignment

alignment

)

Specify the alignment of a non-floating legend.

Use setFloatingPosition to set position and alignment if your legend is floating.

See also:

alignment, setPosition, setFloatingPosition

Definition at line 468 of file KDChartLegend.cpp.

References d.

Referenced by clone().

{
    if( d->alignment == alignment )
        return;
    d->alignment = alignment;
    emitPositionChanged();
}

void AbstractAreaBase::setBackgroundAttributes

(

const BackgroundAttributes &

a

)

[inherited]

Definition at line 112 of file KDChartAbstractAreaBase.cpp.

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

{
    if( d->backgroundAttributes == a )
        return;

    d->backgroundAttributes = a;
    positionHasChanged();
}

void Legend::setBrush	(	uint	dataset,
		const QBrush &	brush
	)

Definition at line 601 of file KDChartLegend.cpp.

References d.

{
    if( d->brushes[ dataset ] == brush ) return;
    d->brushes[ dataset ] = brush;
    setNeedRebuild();
    update();
}

void Legend::setBrushesFromDiagram

(

KDChart::AbstractDiagram *

diagram

)

Definition at line 623 of file KDChartLegend.cpp.

References d, and KDChart::AbstractDiagram::datasetBrushes().

{
    bool bChangesDone = false;
    QList<QBrush> datasetBrushes = diagram->datasetBrushes();
    for( int i = 0; i < datasetBrushes.count(); i++ ){
        if( d->brushes[ i ] != datasetBrushes[ i ] ){
            d->brushes[ i ]  = datasetBrushes[ i ];
            bChangesDone = true;
        }
    }
    if( bChangesDone ) {
        setNeedRebuild();
        update();
    }
}

void Legend::setColor	(	uint	dataset,
		const QColor &	color
	)

Note: there is no color() getter method, since setColor just sets a QBrush with the respective color, so the brush() getter method is sufficient.

Definition at line 593 of file KDChartLegend.cpp.

References d.

Referenced by setDefaultColors(), setRainbowColors(), and setSubduedColors().

{
    if( d->brushes[ dataset ] == color ) return;
    d->brushes[ dataset ] = color;
    setNeedRebuild();
    update();
}

void Legend::setDatasetHidden	(	uint	dataset,
		bool	hidden
	)

Definition at line 1116 of file KDChartLegend.cpp.

References d.

{
    if( hidden && !d->hiddenDatasets.contains( dataset ) )
        d->hiddenDatasets.append( dataset );
    else if( !hidden && d->hiddenDatasets.contains( dataset ) )
        d->hiddenDatasets.removeAll( dataset );
}

void Legend::setDefaultColors

(

)

Definition at line 746 of file KDChartLegend.cpp.

References setColor().

{
    setColor(  0, Qt::red );
    setColor(  1, Qt::green );
    setColor(  2, Qt::blue );
    setColor(  3, Qt::cyan );
    setColor(  4, Qt::magenta );
    setColor(  5, Qt::yellow );
    setColor(  6, Qt::darkRed );
    setColor(  7, Qt::darkGreen );
    setColor(  8, Qt::darkBlue );
    setColor(  9, Qt::darkCyan );
    setColor( 10, Qt::darkMagenta );
    setColor( 11, Qt::darkYellow );
}

void Legend::setDiagram

(

KDChart::AbstractDiagram *

newDiagram

)

A convenience method doing the same as replaceDiagram( newDiagram, 0 );.

Replaces the first diagram by the given diagram. If the legend's list of diagram is empty the given diagram is added to the list.

See also:

diagram, diagrams, addDiagram, removeDiagram, removeDiagrams, replaceDiagram

Definition at line 422 of file KDChartLegend.cpp.

References replaceDiagram().

Referenced by KDChart::Widget::addLegend(), Legend(), KDChart::Widget::replaceLegend(), and KDChart::Widget::setType().

{
    replaceDiagram( newDiagram );
}

void Legend::setFloatingPosition

(

const RelativePosition &

relativePosition

)

Specify the position and alignment of a floating legend.

Use setPosition and setAlignment to set position and alignment if your legend is non-floating.

Note:

When setFloatingPosition is called, the Legend's position value is set to KDChart::Position::Floating automatically.

If your Chart is pointed to by m_chart, your could have the floating legend aligned exactly to the chart's coordinate plane's top-right corner with the following commands:

KDChart::RelativePosition relativePosition;
relativePosition.setReferenceArea( m_chart->coordinatePlane() );
relativePosition.setReferencePosition( Position::NorthEast );
relativePosition.setAlignment( Qt::AlignTop | Qt::AlignRight );
relativePosition.setHorizontalPadding(
    KDChart::Measure( -1.0, KDChartEnums::MeasureCalculationModeAbsolute ) );
relativePosition.setVerticalPadding(
    KDChart::Measure( 0.0, KDChartEnums::MeasureCalculationModeAbsolute ) );
m_legend->setFloatingPosition( relativePosition );

To have the legend positioned at a fixed point, measured from the QPainter's top left corner, you could use the following code code:

KDChart::RelativePosition relativePosition;
relativePosition.setReferencePoints( PositionPoints( QPointF( 0.0, 0.0 ) ) );
relativePosition.setReferencePosition( Position::NorthWest );
relativePosition.setAlignment( Qt::AlignTop | Qt::AlignLeft );
relativePosition.setHorizontalPadding(
    KDChart::Measure( 4.0, KDChartEnums::MeasureCalculationModeAbsolute ) );
relativePosition.setVerticalPadding(
    KDChart::Measure( 4.0, KDChartEnums::MeasureCalculationModeAbsolute ) );
m_legend->setFloatingPosition( relativePosition );

Actually that's exactly the code KD Chart is using as default position for any floating legends, so if you just say setPosition( KDChart::Position::Floating ) without calling setFloatingPosition your legend will be positioned at point 4/4.

See also:

setPosition, setAlignment

Definition at line 494 of file KDChartLegend.cpp.

References d, and KDChart::Position::Floating.

{
    d->position = Position::Floating;
    if( d->relativePosition != relativePosition ){
        d->relativePosition  = relativePosition;
        emitPositionChanged();
    }
}

void AbstractAreaBase::setFrameAttributes

(

const FrameAttributes &

a

)

[inherited]

Definition at line 98 of file KDChartAbstractAreaBase.cpp.

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

Referenced by clone().

{
    if( d->frameAttributes == a )
        return;

    d->frameAttributes = a;
    positionHasChanged();
}

void Legend::setHiddenDatasets

(

const QList< uint >

hiddenDatasets

)

Sets a list of datasets that are to be hidden in the legend.

By passing an empty list, you show all datasets. Note that by default, all datasets are shown, which means that hiddenDatasets() == QList<uint>()

Definition at line 1106 of file KDChartLegend.cpp.

References d.

{
    d->hiddenDatasets = hiddenDatasets;
}

void Legend::setLegendStyle

(

LegendStyle

style

)

Definition at line 191 of file KDChartLegend.cpp.

References d.

Referenced by clone().

{
    if( d->legendStyle == style ) return;
    d->legendStyle = style;
    setNeedRebuild();
}

void Legend::setMarkerAttributes	(	uint	dataset,
		const MarkerAttributes &	markerAttributes
	)

Note that any sizes specified via setMarkerAttributes are ignored, unless you disable the automatic size calculation, by saying setUseAutomaticMarkerSize( false ).

Definition at line 662 of file KDChartLegend.cpp.

References d.

{
    if( d->markerAttributes[dataset] == markerAttributes ) return;
    d->markerAttributes[ dataset ] = markerAttributes;
    setNeedRebuild();
    update();
}

void Legend::setOrientation

(

Qt::Orientation

orientation

)

Definition at line 508 of file KDChartLegend.cpp.

References d.

{
    if( d->orientation == orientation ) return;
    d->orientation = orientation;
    setNeedRebuild();
    emitPositionChanged();
}

void Legend::setPen	(	uint	dataset,
		const QPen &	pen
	)

Definition at line 640 of file KDChartLegend.cpp.

References d.

{
    if( d->pens[dataset] == pen ) return;
    d->pens[dataset] = pen;
    setNeedRebuild();
    update();
}

void Legend::setPosition

(

Position

position

)

Specify the position of a non-floating legend.

Use setFloatingPosition to set position and alignment if your legend is floating.

See also:

setAlignment, setFloatingPosition

Definition at line 448 of file KDChartLegend.cpp.

References d.

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

{
    if( d->position == position )
        return;
    d->position = position;
    emitPositionChanged();
}

void Legend::setRainbowColors

(

)

Definition at line 762 of file KDChartLegend.cpp.

References brush(), and setColor().

{
    setColor(  0, QColor(255,  0,196) );
    setColor(  1, QColor(255,  0, 96) );
    setColor(  2, QColor(255, 128,64) );
    setColor(  3, Qt::yellow );
    setColor(  4, Qt::green );
    setColor(  5, Qt::cyan );
    setColor(  6, QColor( 96, 96,255) );
    setColor(  7, QColor(160,  0,255) );
    for( int i = 8; i < 16; ++i )
        setColor( i, brush( i - 8 ).color().light() );
}

void Legend::setReferenceArea

(

const QWidget *

area

)

Specifies the reference area for font size of title text, and for font size of the item texts, IF automatic area detection is set.

Note:

This parameter is ignored, if the Measure given for setTitleTextAttributes (or setTextAttributes, resp.) is not specifying automatic area detection.

If no reference area is specified, but automatic area detection is set, then the size of the legend's parent widget will be used.

See also:

KDChart::Measure, KDChartEnums::MeasureCalculationMode

Definition at line 305 of file KDChartLegend.cpp.

References d.

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

{
    if( area == d->referenceArea ) return;
    d->referenceArea = area;
    setNeedRebuild();
}

void Legend::setShowLines

(

bool

legendShowLines

)

Definition at line 535 of file KDChartLegend.cpp.

References d.

{
    if( d->showLines == legendShowLines ) return;
    d->showLines = legendShowLines;
    setNeedRebuild();
    emitPositionChanged();
}

void Legend::setSortOrder

(

Qt::SortOrder

order

)

Definition at line 521 of file KDChartLegend.cpp.

References d.

{
    if( d->order == order )
        return;
    d->order = order;
    setNeedRebuild();
    emitPositionChanged();
}

void Legend::setSpacing

(

uint

space

)

Definition at line 733 of file KDChartLegend.cpp.

References d.

{
    if( d->spacing == space && d->layout->spacing() == static_cast<int>(space) ) return;
    d->spacing = space;
    d->layout->setSpacing( space );
    setNeedRebuild();
}

void Legend::setSubduedColors

(

bool

ordered = false

)

Definition at line 776 of file KDChartLegend.cpp.

References setColor().

{
static const int NUM_SUBDUEDCOLORS = 18;
static const QColor SUBDUEDCOLORS[ NUM_SUBDUEDCOLORS ] = {
    QColor( 0xe0,0x7f,0x70 ),
    QColor( 0xe2,0xa5,0x6f ),
    QColor( 0xe0,0xc9,0x70 ),
    QColor( 0xd1,0xe0,0x70 ),
    QColor( 0xac,0xe0,0x70 ),
    QColor( 0x86,0xe0,0x70 ),
    QColor( 0x70,0xe0,0x7f ),
    QColor( 0x70,0xe0,0xa4 ),
    QColor( 0x70,0xe0,0xc9 ),
    QColor( 0x70,0xd1,0xe0 ),
    QColor( 0x70,0xac,0xe0 ),
    QColor( 0x70,0x86,0xe0 ),
    QColor( 0x7f,0x70,0xe0 ),
    QColor( 0xa4,0x70,0xe0 ),
    QColor( 0xc9,0x70,0xe0 ),
    QColor( 0xe0,0x70,0xd1 ),
    QColor( 0xe0,0x70,0xac ),
    QColor( 0xe0,0x70,0x86 ),
};
    if( ordered )
        for(int i=0; i<NUM_SUBDUEDCOLORS; ++i)
            setColor( i, SUBDUEDCOLORS[i] );
    else{
        setColor( 0, SUBDUEDCOLORS[ 0] );
        setColor( 1, SUBDUEDCOLORS[ 5] );
        setColor( 2, SUBDUEDCOLORS[10] );
        setColor( 3, SUBDUEDCOLORS[15] );
        setColor( 4, SUBDUEDCOLORS[ 2] );
        setColor( 5, SUBDUEDCOLORS[ 7] );
        setColor( 6, SUBDUEDCOLORS[12] );
        setColor( 7, SUBDUEDCOLORS[17] );
        setColor( 8, SUBDUEDCOLORS[ 4] );
        setColor( 9, SUBDUEDCOLORS[ 9] );
        setColor(10, SUBDUEDCOLORS[14] );
        setColor(11, SUBDUEDCOLORS[ 1] );
        setColor(12, SUBDUEDCOLORS[ 6] );
        setColor(13, SUBDUEDCOLORS[11] );
        setColor(14, SUBDUEDCOLORS[16] );
        setColor(15, SUBDUEDCOLORS[ 3] );
        setColor(16, SUBDUEDCOLORS[ 8] );
        setColor(17, SUBDUEDCOLORS[13] );
    }
}

void Legend::setText	(	uint	dataset,
		const QString &	text
	)

Definition at line 572 of file KDChartLegend.cpp.

References d.

{
    if( d->texts[ dataset ] == text ) return;
    d->texts[ dataset ] = text;
    setNeedRebuild();
}

void Legend::setTextAlignment

(

Qt::Alignment

alignment

)

Specify the alignment of the text elements within the legend.

See also:

textAlignment()

Definition at line 481 of file KDChartLegend.cpp.

References d.

Referenced by clone().

{
    if( d->textAlignment == alignment )
        return;
    d->textAlignment = alignment;
    emitPositionChanged();
}

void Legend::setTextAttributes

(

const TextAttributes &

a

)

Definition at line 685 of file KDChartLegend.cpp.

References d.

Referenced by KDChart::Chart::addLegend(), and clone().

{
    if( d->textAttributes == a ) return;
    d->textAttributes = a;
    setNeedRebuild();
}

void Legend::setTitleText

(

const QString &

text

)

Definition at line 697 of file KDChartLegend.cpp.

References d.

{
    if( d->titleText == text ) return;
    d->titleText = text;
    setNeedRebuild();
}

void Legend::setTitleTextAttributes

(

const TextAttributes &

a

)

Definition at line 709 of file KDChartLegend.cpp.

References d.

Referenced by KDChart::Chart::addLegend(), and clone().

{
    if( d->titleTextAttributes == a ) return;
    d->titleTextAttributes = a;
    setNeedRebuild();
}

void Legend::setUseAutomaticMarkerSize

(

bool

useAutomaticMarkerSize

)

This option is on by default, it means that Marker sizes in the Legend will be the same as the font height used for their respective label texts.

Set this to false, if you want to specify the marker sizes via setMarkerAttributes or if you want the Legend to use the same marker sizes as they are used in the Diagrams.

Definition at line 548 of file KDChartLegend.cpp.

References d.

Referenced by clone().

{
    d->useAutomaticMarkerSize = useAutomaticMarkerSize;
    setNeedRebuild();
    emitPositionChanged();
}

void Legend::setVisible

(

bool

visible

)

[virtual]

Definition at line 433 of file KDChartLegend.cpp.

Referenced by KDChart::Chart::addLegend(), and KDChart::Chart::takeLegend().

{
    if( isVisible() == visible )
        return;
    QWidget::setVisible( visible );
    emitPositionChanged();
}

bool Legend::showLines

(

)

const

Definition at line 543 of file KDChartLegend.cpp.

References d.

Referenced by compare().

{
    return d->showLines;
}

QSize Legend::sizeHint

(

)

const [virtual]

Definition at line 152 of file KDChartLegend.cpp.

References d.

Referenced by minimumSizeHint(), KDChart::Chart::reLayoutFloatingLegends(), and resizeEvent().

{
#ifdef DEBUG_LEGEND_PAINT
    qDebug()  << "Legend::sizeHint() started";
#endif
    Q_FOREACH( KDChart::AbstractLayoutItem* layoutItem, d->layoutItems ) {
        layoutItem->sizeHint();
    }
    return AbstractAreaWidget::sizeHint();
}

Qt::SortOrder Legend::sortOrder

(

)

const

Definition at line 530 of file KDChartLegend.cpp.

References d.

{
    return d->order;
}

uint Legend::spacing

(

)

const

Definition at line 741 of file KDChartLegend.cpp.

References d.

Referenced by compare().

{
    return d->spacing;
}

QString Legend::text

(

uint

dataset

)

const

Definition at line 579 of file KDChartLegend.cpp.

References d.

{
    if( d->texts.find( dataset ) != d->texts.end() ){
        return d->texts[ dataset ];
    }else{
        return d->modelLabels[ dataset ];
    }
}

Qt::Alignment Legend::textAlignment

(

)

const

Returns the alignment used while rendering text elements within the legend.

See also:

setTextAlignment()

Definition at line 489 of file KDChartLegend.cpp.

References d.

Referenced by clone(), and compare().

{
    return d->textAlignment;
}

TextAttributes Legend::textAttributes

(

)

const

Definition at line 692 of file KDChartLegend.cpp.

References d.

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

{
    return d->textAttributes;
}

const QMap< uint, QString > Legend::texts

(

)

const

Definition at line 588 of file KDChartLegend.cpp.

References d.

Referenced by compare().

{
    return d->texts;
}

QString Legend::titleText

(

)

const

Definition at line 704 of file KDChartLegend.cpp.

References d.

Referenced by compare().

{
    return d->titleText;
}

TextAttributes Legend::titleTextAttributes

(

)

const

Definition at line 716 of file KDChartLegend.cpp.

References d.

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

{
    return d->titleTextAttributes;
}

bool Legend::useAutomaticMarkerSize

(

)

const

Definition at line 555 of file KDChartLegend.cpp.

References d.

Referenced by clone(), and compare().

{
    return d->useAutomaticMarkerSize;
}

---

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

• KDChartLegend.h
• KDChartLegend.cpp

---