A class which draws a legend inside the plot canvas. More...

#include <qwt_plot_legenditem.h>

Inheritance diagram for QwtPlotLegendItem:

Classes
class	PrivateData

Public Types
enum	BackgroundMode { LegendBackground , ItemBackground }
	Background mode. More...

Public Types inherited from QwtPlotItem
enum	RttiValues { Rtti_PlotItem = 0 , Rtti_PlotGrid , Rtti_PlotScale , Rtti_PlotLegend , Rtti_PlotMarker , Rtti_PlotCurve , Rtti_PlotSpectroCurve , Rtti_PlotIntervalCurve , Rtti_PlotHistogram , Rtti_PlotSpectrogram , Rtti_PlotGraphic , Rtti_PlotTradingCurve , Rtti_PlotBarChart , Rtti_PlotMultiBarChart , Rtti_PlotShape , Rtti_PlotTextLabel , Rtti_PlotZone , Rtti_PlotVectorField , Rtti_PlotArrowMarker , Rtti_PlotBoxChart , Rtti_PlotUserItem = 1000 }
	Runtime type information. More...

enum	ItemAttribute { Legend = 0x01 , AutoScale = 0x02 , Margins = 0x04 }
	Plot Item Attributes. More...

enum	ItemInterest { ScaleInterest = 0x01 , LegendInterest = 0x02 }
	Plot Item Interests. More...

enum	RenderHint { RenderAntialiased = 0x1 }
	Render hints . More...

Public Member Functions
	QwtPlotLegendItem ()
	Constructor.

virtual	~QwtPlotLegendItem ()
	Destructor.

virtual int	rtti () const override
	Get the runtime type information.

void	setAlignmentInCanvas (Qt::Alignment)
	Set the alignment in canvas.

Qt::Alignment	alignmentInCanvas () const
	Get the alignment in canvas.

void	setOffsetInCanvas (Qt::Orientations, int numPixels)
	Set the offset in canvas.

int	offsetInCanvas (Qt::Orientation) const
	Get the offset in canvas.

void	setMaxColumns (uint)
	Set the maximum number of columns.

uint	maxColumns () const
	Get the maximum number of columns.

void	setMargin (int)
	Set the margin.

int	margin () const
	Get the margin.

void	setSpacing (int)
	Set the spacing.

int	spacing () const
	Get the spacing.

void	setItemMargin (int)
	Set the item margin.

int	itemMargin () const
	Get the item margin.

void	setItemSpacing (int)
	Set the item spacing.

int	itemSpacing () const
	Get the item spacing.

void	setFont (const QFont &)
	Set the font.

QFont	font () const
	Get the font.

void	setBorderRadius (double)
	Set the border radius.

double	borderRadius () const
	Get the border radius.

void	setBorderPen (const QPen &)
	Set the border pen.

QPen	borderPen () const
	Get the border pen.

void	setBackgroundBrush (const QBrush &)
	Set the background brush.

QBrush	backgroundBrush () const
	Get the background brush.

void	setBackgroundMode (BackgroundMode)
	Set the background mode.

BackgroundMode	backgroundMode () const
	Get the background mode.

void	setTextPen (const QPen &)
	Set the text pen.

QPen	textPen () const
	Get the text pen.

virtual void	draw (QPainter *, const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &canvasRect) const override
	Draw the legend item.

void	clearLegend ()
	Clear the legend.

virtual void	updateLegend (const QwtPlotItem *, const QList< QwtLegendData > &) override
	Update the legend.

virtual QRect	geometry (const QRectF &canvasRect) const
	Get the geometry.

virtual QSize	minimumSize (const QwtLegendData &) const
	Get the minimum size.

virtual int	heightForWidth (const QwtLegendData &, int width) const
	Get the height for width.

QList< const QwtPlotItem * >	plotItems () const
	Get the plot items.

QList< QRect >	legendGeometries (const QwtPlotItem *) const
	Get the legend geometries.

Public Member Functions inherited from QwtPlotItem
	QwtPlotItem ()
	Default constructor.

	QwtPlotItem (const QString &title)
	Constructor with title as QString.

	QwtPlotItem (const QwtText &title)
	Constructor with title as QwtText.

virtual	~QwtPlotItem ()
	Destructor.

void	attach (QwtPlot *plot)
	Attach the item to a plot.

void	detach ()
	Detach the item from the plot.

QwtPlot *	plot () const
	Get the plot the item is attached to.

void	setTitle (const QString &title)
	Set the title using a QString.

void	setTitle (const QwtText &title)
	Set the title using a QwtText.

const QwtText &	title () const
	Get the title.

void	setItemAttribute (ItemAttribute, bool on=true)
	Set an item attribute.

bool	testItemAttribute (ItemAttribute) const
	Test an item attribute.

void	setItemInterest (ItemInterest, bool on=true)
	Set an item interest.

bool	testItemInterest (ItemInterest) const
	Test an item interest.

void	setRenderHint (RenderHint, bool on=true)
	Set a render hint.

bool	testRenderHint (RenderHint) const
	Test a render hint.

void	setRenderThreadCount (uint numThreads)
	Set the number of render threads.

uint	renderThreadCount () const
	Get the number of render threads.

void	setLegendIconSize (const QSize &)
	Set the legend icon size.

QSize	legendIconSize () const
	Get the legend icon size.

double	z () const
	Get the z-value.

void	setZ (double z)
	Set the z-value.

void	show ()
	Show the item.

void	hide ()
	Hide the item.

virtual void	setVisible (bool)
	Set the visibility.

bool	isVisible () const
	Check if the item is visible.

void	setAxes (QwtAxisId xAxis, QwtAxisId yAxis)
	Set both axes.

void	setXAxis (QwtAxisId)
	Set the x-axis.

QwtAxisId	xAxis () const
	Get the x-axis.

void	setYAxis (QwtAxisId)
	Set the y-axis.

QwtAxisId	yAxis () const
	Get the y-axis.

virtual void	itemChanged ()
	Notify the plot that the item has changed.

virtual void	legendChanged ()
	Notify the item that the legend has changed.

virtual QRectF	boundingRect () const
	Get the bounding rectangle.

virtual void	getCanvasMarginHint (const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &canvasRect, double &left, double &top, double &right, double &bottom) const
	Get margin hints for the canvas.

virtual void	updateScaleDiv (const QwtScaleDiv &, const QwtScaleDiv &)
	Update the item with new scale divisions.

QRectF	scaleRect (const QwtScaleMap &, const QwtScaleMap &) const
	Calculate the scale rectangle.

QRectF	paintRect (const QwtScaleMap &, const QwtScaleMap &) const
	Calculate the paint rectangle.

virtual QList< QwtLegendData >	legendData () const
	Return legend data.

virtual QwtGraphic	legendIcon (int index, const QSizeF &) const
	Return a legend icon.

Protected Member Functions
virtual void	drawLegendData (QPainter , const QwtPlotItem , const QwtLegendData &, const QRectF &) const
	Draw the legend data.

virtual void	drawBackground (QPainter *, const QRectF &rect) const
	Draw the background.

Protected Member Functions inherited from QwtPlotItem
QwtGraphic	defaultIcon (const QBrush &, const QSizeF &) const
	Create a default icon.

Detailed Description

A class which draws a legend inside the plot canvas.

Member Enumeration Documentation

◆ BackgroundMode

enum QwtPlotLegendItem::BackgroundMode

Background mode.

Enumerator
LegendBackground	The legend has a background.
ItemBackground	Each item has a background.

Constructor & Destructor Documentation

◆ QwtPlotLegendItem()

QwtPlotLegendItem::QwtPlotLegendItem ( )

explicit

Constructor.

◆ ~QwtPlotLegendItem()

QwtPlotLegendItem::~QwtPlotLegendItem ( )

virtual

Destructor.

Destructor

.

Member Function Documentation

◆ alignmentInCanvas()

Qt::Alignment QwtPlotLegendItem::alignmentInCanvas ( ) const

Get the alignment in canvas.

Get the alignment flags.

◆ backgroundBrush()

QBrush QwtPlotLegendItem::backgroundBrush ( ) const

Get the background brush.

Get the brush used to fill the background.

◆ backgroundMode()

QwtPlotLegendItem::BackgroundMode QwtPlotLegendItem::backgroundMode ( ) const

Get the background mode.

◆ borderPen()

QPen QwtPlotLegendItem::borderPen ( ) const

Get the border pen.

Get the pen for drawing the border.

◆ borderRadius()

double QwtPlotLegendItem::borderRadius ( ) const

Get the border radius.

Get the radius of the border.

◆ clearLegend()

void QwtPlotLegendItem::clearLegend ( )

Clear the legend.

Remove all items from the legend

.

◆ draw()

void QwtPlotLegendItem::draw	(	QPainter *	painter,
		const QwtScaleMap &	xMap,
		const QwtScaleMap &	yMap,
		const QRectF &	canvasRect
	)		const

overridevirtual

Draw the legend item.

Draw the legend.

Implements QwtPlotItem.

◆ drawBackground()

void QwtPlotLegendItem::drawBackground	(	QPainter *	painter,
		const QRectF &	rect
	)		const

protectedvirtual

Draw the background.

Draw a rounded rect.

Parameters

painter	Painter
rect	Bounding rectangle

See also: setBorderRadius(), setBorderPen(), setBackgroundBrush(), setBackgroundMode()

◆ drawLegendData()

void QwtPlotLegendItem::drawLegendData	(	QPainter *	painter,
		const QwtPlotItem *	plotItem,
		const QwtLegendData &	data,
		const QRectF &	rect
	)		const

protectedvirtual

Draw the legend data.

Draw an entry on the legend.

Parameters

painter	Qt Painter
plotItem	Plot item, represented by the entry
data	Attributes of the legend entry
rect	Bounding rectangle for the entry

◆ font()

QFont QwtPlotLegendItem::font ( ) const

Get the font.

Get the font used for drawing the text label.

◆ geometry()

QRect QwtPlotLegendItem::geometry ( const QRectF & canvasRect ) const

virtual

Get the geometry.

Calculate the geometry of the legend on the canvas.

◆ heightForWidth()

int QwtPlotLegendItem::heightForWidth	(	const QwtLegendData &	data,
		int	width
	)		const

virtual

Get the height for width.

Get the preferred height for a given width.

◆ itemMargin()

int QwtPlotLegendItem::itemMargin ( ) const

Get the item margin.

Get the margin around each item.

◆ itemSpacing()

int QwtPlotLegendItem::itemSpacing ( ) const

Get the item spacing.

Get the spacing inside of each item.

◆ legendGeometries()

QList< QRect > QwtPlotLegendItem::legendGeometries ( const QwtPlotItem * plotItem ) const

Get the legend geometries.

Get geometries of the items of a plot item.

◆ margin()

int QwtPlotLegendItem::margin ( ) const

Get the margin.

Get the margin around the legend items.

◆ maxColumns()

uint QwtPlotLegendItem::maxColumns ( ) const

Get the maximum number of columns.

◆ minimumSize()

QSize QwtPlotLegendItem::minimumSize ( const QwtLegendData & data ) const

virtual

Get the minimum size.

Get the minimum size hint needed to display an entry.

◆ offsetInCanvas()

int QwtPlotLegendItem::offsetInCanvas ( Qt::Orientation orientation ) const

Get the offset in canvas.

Get the distance between the legend and the canvas border.

◆ plotItems()

QList< const QwtPlotItem * > QwtPlotLegendItem::plotItems ( ) const

Get the plot items.

Get all plot items with an entry on the legend.

◆ rtti()

int QwtPlotLegendItem::rtti ( ) const

overridevirtual

Get the runtime type information.

Reimplemented from QwtPlotItem.

◆ setAlignmentInCanvas()

void QwtPlotLegendItem::setAlignmentInCanvas ( Qt::Alignment alignment )

Set the alignment in canvas.

Set the alignment of the legend within the canvas.

◆ setBackgroundBrush()

void QwtPlotLegendItem::setBackgroundBrush ( const QBrush & brush )

Set the background brush.

◆ setBackgroundMode()

void QwtPlotLegendItem::setBackgroundMode ( BackgroundMode mode )

Set the background mode.

◆ setBorderPen()

void QwtPlotLegendItem::setBorderPen ( const QPen & pen )

Set the border pen.

Set the pen for drawing the border.

◆ setBorderRadius()

void QwtPlotLegendItem::setBorderRadius ( double radius )

Set the border radius.

Set the radius for the border.

◆ setFont()

void QwtPlotLegendItem::setFont ( const QFont & font )

Set the font.

Change the font used for drawing the text label.

◆ setItemMargin()

void QwtPlotLegendItem::setItemMargin ( int margin )

Set the item margin.

Set the margin around each item.

◆ setItemSpacing()

void QwtPlotLegendItem::setItemSpacing ( int spacing )

Set the item spacing.

Set the spacing inside of each item.

◆ setMargin()

void QwtPlotLegendItem::setMargin ( int margin )

Set the margin.

Set the margin around legend items.

◆ setMaxColumns()

void QwtPlotLegendItem::setMaxColumns ( uint maxColumns )

Set the maximum number of columns.

Limit the number of columns.

◆ setOffsetInCanvas()

void QwtPlotLegendItem::setOffsetInCanvas	(	Qt::Orientations	orientations,
		int	numPixels
	)

Set the offset in canvas.

Set the distance between the legend and the canvas border.

◆ setSpacing()

void QwtPlotLegendItem::setSpacing ( int spacing )

Set the spacing.

Set the spacing between the legend items.

◆ setTextPen()

void QwtPlotLegendItem::setTextPen ( const QPen & pen )

Set the text pen.

Set the pen for drawing text labels.

◆ spacing()

int QwtPlotLegendItem::spacing ( ) const

Get the spacing.

Get the spacing between the legend items.

◆ textPen()

QPen QwtPlotLegendItem::textPen ( ) const

Get the text pen.

Get the pen for drawing text labels.

◆ updateLegend()

void QwtPlotLegendItem::updateLegend	(	const QwtPlotItem *	plotItem,
		const QList< QwtLegendData > &	data
	)

overridevirtual

Update the legend.

Update the legend items according to modifications of a plot item.

Reimplemented from QwtPlotItem.

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

/home/runner/work/QWT/QWT/src/plot/qwt_plot_legenditem.h
/home/runner/work/QWT/QWT/src/plot/qwt_plot_legenditem.cpp

Classes

Public Types

Public Member Functions

Protected Member Functions

Detailed Description

Member Enumeration Documentation

◆ BackgroundMode

Constructor & Destructor Documentation

◆ QwtPlotLegendItem()

◆ ~QwtPlotLegendItem()

Member Function Documentation

◆ alignmentInCanvas()

◆ backgroundBrush()

◆ backgroundMode()

◆ borderPen()

◆ borderRadius()

◆ clearLegend()

◆ draw()

◆ drawBackground()

◆ drawLegendData()

◆ font()

◆ geometry()

◆ heightForWidth()

◆ itemMargin()

◆ itemSpacing()

◆ legendGeometries()

◆ margin()

◆ maxColumns()

◆ minimumSize()

◆ offsetInCanvas()

◆ plotItems()

◆ rtti()

◆ setAlignmentInCanvas()

◆ setBackgroundBrush()

◆ setBackgroundMode()

◆ setBorderPen()

◆ setBorderRadius()

◆ setFont()

◆ setItemMargin()

◆ setItemSpacing()

◆ setMargin()

◆ setMaxColumns()

◆ setOffsetInCanvas()

◆ setSpacing()

◆ setTextPen()

◆ spacing()

◆ textPen()

◆ updateLegend()