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_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 QWT_OVERRIDE

void	setAlignmentInCanvas (Qt::Alignment)
	Set the alignmnet.

Qt::Alignment	alignmentInCanvas () const

void	setOffsetInCanvas (Qt::Orientations, int numPixels)
	Set the distance between the legend and the canvas border.

int	offsetInCanvas (Qt::Orientation) const

void	setMaxColumns (uint)
	Limit the number of columns.

uint	maxColumns () const

void	setMargin (int)
	Set the margin around legend items.

int	margin () const

void	setSpacing (int)
	Set the spacing between the legend items.

int	spacing () const

void	setItemMargin (int)
	Set the margin around each item.

int	itemMargin () const

void	setItemSpacing (int)
	Set the spacing inside of each item.

int	itemSpacing () const

void	setFont (const QFont &)
	Change the font used for drawing the text label.

QFont	font () const

void	setBorderRadius (double)
	Set the radius for the border.

double	borderRadius () const

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

QPen	borderPen () const

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

QBrush	backgroundBrush () const

void	setBackgroundMode (BackgroundMode)
	Set the background mode.

BackgroundMode	backgroundMode () const

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

QPen	textPen () const

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

void	clearLegend ()
	Remove all items from the legend.

virtual void	updateLegend (const QwtPlotItem *, const QList< QwtLegendData > &) QWT_OVERRIDE
	Update the legend items according to modifications of a plot item.

virtual QRect	geometry (const QRectF &canvasRect) const
	Calculate the geometry of the legend on the canvas.

virtual QSize	minimumSize (const QwtLegendData &) const
	Minimum size hint needed to display an entry.

virtual int	heightForWidth (const QwtLegendData &, int width) const

QList< const QwtPlotItem * >	plotItems () const

QList< QRect >	legendGeometries (const QwtPlotItem *) const

Public Member Functions inherited from QwtPlotItem
	QwtPlotItem ()
	Constructor.

	QwtPlotItem (const QString &title)
	Constructor.

	QwtPlotItem (const QwtText &title)
	Constructor.

virtual	~QwtPlotItem ()
	Destroy the QwtPlotItem.

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

void	detach ()
	This method detaches a QwtPlotItem from any QwtPlot it has been associated with.

QwtPlot *	plot () const
	Return attached plot.

void	setTitle (const QString &title)
	Set a new title.

void	setTitle (const QwtText &title)
	Set a new title.

const QwtText &	title () const

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

bool	testItemAttribute (ItemAttribute) const
	Test an item attribute.

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

bool	testItemInterest (ItemInterest) const
	Test an item interest.

void	setRenderHint (RenderHint, bool on=true)
	Toggle an render hint.

bool	testRenderHint (RenderHint) const
	Test a render hint.

void	setRenderThreadCount (uint numThreads)
	On multi core systems rendering of certain plot item ( f.e QwtPlotRasterItem ) can be done in parallel in several threads.

uint	renderThreadCount () const

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

QSize	legendIconSize () const

double	z () const
	Plot items are painted in increasing z-order.

void	setZ (double z)
	Set the z value.

void	show ()
	Show the item.

void	hide ()
	Hide the item.

virtual void	setVisible (bool)
	Show/Hide the item.

bool	isVisible () const

void	setAxes (QwtAxisId xAxis, QwtAxisId yAxis)
	Set X and Y axis.

void	setXAxis (QwtAxisId)
	Set the X axis.

QwtAxisId	xAxis () const
	Return xAxis.

void	setYAxis (QwtAxisId)
	Set the Y axis.

QwtAxisId	yAxis () const
	Return yAxis.

virtual void	itemChanged ()
	Update the legend and call QwtPlot::autoRefresh() for the parent plot.

virtual void	legendChanged ()
	Update the legend of the parent plot.

virtual QRectF	boundingRect () const

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

virtual void	updateScaleDiv (const QwtScaleDiv &, const QwtScaleDiv &)
	Update the item to changes of the axes scale division.

QRectF	scaleRect (const QwtScaleMap &, const QwtScaleMap &) const
	Calculate the bounding scale rectangle of 2 maps.

QRectF	paintRect (const QwtScaleMap &, const QwtScaleMap &) const
	Calculate the bounding paint rectangle of 2 maps.

virtual QList< QwtLegendData >	legendData () const
	Return all information, that is needed to represent the item on the legend.

virtual QwtGraphic	legendIcon (int index, const QSizeF &) const

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

virtual void	drawBackground (QPainter *, const QRectF &rect) const
	Draw a rounded rect.

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

Detailed Description

A class which draws a legend inside the plot canvas.

QwtPlotLegendItem can be used to draw a inside the plot canvas. It can be used together with a QwtLegend or instead of it to have more space for the plot canvas.

In opposite to QwtLegend the legend item is not interactive. To identify mouse clicks on a legend item an event filter needs to be installed catching mouse events ob the plot canvas. The geometries of the legend items are available using legendGeometries().

The legend item is aligned to plot canvas according to its alignment() flags. It might have a background for the complete legend ( usually semi transparent ) or for each legend item.

Note: An external QwtLegend with a transparent background on top the plot canvas might be another option with a similar effect.

Member Enumeration Documentation

◆ BackgroundMode

enum QwtPlotLegendItem::BackgroundMode

Background mode.

Depending on the mode the complete legend or each item might have an background.

The default setting is LegendBackground.

See also: setBackgroundMode(), setBackgroundBrush(), drawBackground()

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

Member Function Documentation

◆ alignmentInCanvas()

Qt::Alignment QwtPlotLegendItem::alignmentInCanvas ( ) const

Returns: Alignment flags

See also: setAlignmentInCanvas()

◆ backgroundBrush()

QBrush QwtPlotLegendItem::backgroundBrush ( ) const

Returns: Brush is used to fill the background

See also: setBackgroundBrush(), backgroundMode(), drawBackground()

◆ backgroundMode()

QwtPlotLegendItem::BackgroundMode QwtPlotLegendItem::backgroundMode ( ) const

Returns: backgroundMode

See also: setBackgroundMode(), backgroundBrush(), drawBackground()

◆ borderPen()

QPen QwtPlotLegendItem::borderPen ( ) const

Returns: Pen for drawing the border

See also: setBorderPen(), backgroundBrush()

◆ borderRadius()

double QwtPlotLegendItem::borderRadius ( ) const

Returns: Radius of the border

See also: setBorderRadius(), setBorderPen()

◆ draw()

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

virtual

Draw the legend.

Parameters

painter	Painter
xMap	x Scale Map
yMap	y Scale Map
canvasRect	Contents rectangle of the canvas in painter coordinates

Implements QwtPlotItem.

◆ drawBackground()

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

protectedvirtual

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

Returns: Font used for drawing the text label

See also: setFont()

◆ geometry()

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

virtual

Calculate the geometry of the legend on the canvas.

Parameters

canvasRect Geometry of the canvas

Returns: Geometry of the legend

◆ heightForWidth()

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

virtual

Returns: The preferred height, for a width.

Parameters

data	Attributes of the legend entry
width	Width

◆ itemMargin()

int QwtPlotLegendItem::itemMargin ( ) const

Returns: Margin around each item

See also: setItemMargin(), itemSpacing(), margin(), spacing()

◆ itemSpacing()

int QwtPlotLegendItem::itemSpacing ( ) const

Returns: Spacing inside of each item

See also: setItemSpacing(), itemMargin(), margin(), spacing()

◆ legendGeometries()

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

Returns: Geometries of the items of a plot item

Note: Usually a plot item has only one entry on the legend

◆ margin()

int QwtPlotLegendItem::margin ( ) const

Returns: Margin around the legend items

See also: setMargin(), spacing(), itemMargin(), itemSpacing()

◆ maxColumns()

uint QwtPlotLegendItem::maxColumns ( ) const

Returns: Maximum number of columns

See also: maxColumns(), QwtDynGridLayout::maxColumns()

◆ minimumSize()

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

virtual

Minimum size hint needed to display an entry.

Parameters

data	Attributes of the legend entry

Returns: Minimum size

◆ offsetInCanvas()

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

Parameters

orientation Qt::Horizontal is for the left/right, Qt::Vertical for the top/bottom padding.

Returns: Distance between the legend and the canvas border

See also: setOffsetInCanvas()

◆ plotItems()

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

Returns: All plot items with an entry on the legend

Note: A plot item might have more than one entry on the legend

◆ rtti()

int QwtPlotLegendItem::rtti ( ) const

virtual

Returns: QwtPlotItem::Rtti_PlotLegend

Reimplemented from QwtPlotItem.

◆ setAlignmentInCanvas()

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

Set the alignmnet.

Alignment means the position of the legend relative to the geometry of the plot canvas.

Parameters

alignment Alignment flags

See also: alignmentInCanvas(), setMaxColumns()

Note: To align a legend with many items horizontally the number of columns need to be limited

◆ setBackgroundBrush()

void QwtPlotLegendItem::setBackgroundBrush ( const QBrush & brush )

Set the background brush.

The brush is used to fill the background

Parameters

brush Brush

See also: backgroundBrush(), setBackgroundMode(), drawBackground()

◆ setBackgroundMode()

void QwtPlotLegendItem::setBackgroundMode ( BackgroundMode mode )

Set the background mode.

Depending on the mode the complete legend or each item might have an background.

The default setting is LegendBackground.

See also: backgroundMode(), setBackgroundBrush(), drawBackground()

◆ setBorderPen()

void QwtPlotLegendItem::setBorderPen ( const QPen & pen )

Set the pen for drawing the border.

Parameters

pen	Border pen

See also: borderPen(), setBackgroundBrush()

◆ setBorderRadius()

void QwtPlotLegendItem::setBorderRadius ( double radius )

Set the radius for the border.

Parameters

radius A value <= 0 defines a rectangular border

See also: borderRadius(), setBorderPen()

◆ setFont()

void QwtPlotLegendItem::setFont ( const QFont & font )

Change the font used for drawing the text label.

Parameters

font	Legend font

See also: font()

◆ setItemMargin()

void QwtPlotLegendItem::setItemMargin ( int margin )

Set the margin around each item.

Parameters

margin Margin

See also: itemMargin(), setItemSpacing(), setMargin(), setSpacing()

◆ setItemSpacing()

void QwtPlotLegendItem::setItemSpacing ( int spacing )

Set the spacing inside of each item.

Parameters

spacing Spacing

See also: itemSpacing(), setItemMargin(), setMargin(), setSpacing()

◆ setMargin()

void QwtPlotLegendItem::setMargin ( int margin )

Set the margin around legend items.

The default setting for the margin is 0.

Parameters

margin Margin in pixels

See also: margin(), setSpacing(), setItemMargin(), setItemSpacing

◆ setMaxColumns()

void QwtPlotLegendItem::setMaxColumns ( uint maxColumns )

Limit the number of columns.

When aligning the legend horizontally ( Qt::AlignLeft, Qt::AlignRight ) the number of columns needs to be limited to avoid, that the width of the legend grows with an increasing number of entries.

Parameters

maxColumns Maximum number of columns. 0 means unlimited.

See also: maxColumns(), QwtDynGridLayout::setMaxColumns()

◆ setOffsetInCanvas()

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

Set the distance between the legend and the canvas border.

The default setting is 10 pixels.

Parameters

orientations	Qt::Horizontal is for the left/right, Qt::Vertical for the top/bottom offset.
numPixels	Distance in pixels

See also: setMargin()

◆ setSpacing()

void QwtPlotLegendItem::setSpacing ( int spacing )

Set the spacing between the legend items.

Parameters

spacing Spacing in pixels

See also: spacing(), setMargin()

◆ setTextPen()

void QwtPlotLegendItem::setTextPen ( const QPen & pen )

Set the pen for drawing text labels.

Parameters

pen Text pen

See also: textPen(), setFont()

◆ spacing()

int QwtPlotLegendItem::spacing ( ) const

Returns: Spacing between the legend items

See also: setSpacing(), margin(), itemSpacing(), itemMargin()

◆ textPen()

QPen QwtPlotLegendItem::textPen ( ) const

Returns: Pen for drawing text labels

See also: setTextPen(), font()

◆ updateLegend()

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

virtual

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

Parameters

plotItem	Plot item
data	Attributes of the legend entries

Reimplemented from QwtPlotItem.

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

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

Classes

Public Types

Public Member Functions

Protected Member Functions

Detailed Description

Member Enumeration Documentation

◆ BackgroundMode

Member Function Documentation

◆ alignmentInCanvas()

◆ backgroundBrush()

◆ backgroundMode()

◆ borderPen()

◆ borderRadius()

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