#include <qwt_plot_layout.h>

类 QwtPlotLayout 继承关系图:

类
class	PrivateData

Public 类型
enum	Option { AlignScales = 0x01 , IgnoreScrollbars = 0x02 , IgnoreFrames = 0x04 , IgnoreLegend = 0x08 , IgnoreTitle = 0x10 , IgnoreFooter = 0x20 }
	Options to configure the plot layout engine 更多...

Public 成员函数
	QwtPlotLayout ()
	Constructor

void	setCanvasMargin (int margin, int axis=-1)
	Set the canvas margin for a specific axis position

int	canvasMargin (int axisId) const
	Get the canvas margin for a specific axis position

void	setAlignCanvasToScales (bool)
	Set the align-canvas-to-axis-scales flag for all axes

void	setAlignCanvasToScale (int axisId, bool)
	Set the align-canvas-to-axis-scales setting for a specific axis

bool	alignCanvasToScale (int axisId) const
	Get the align-canvas-to-axis-scales setting for a specific axis

void	setSpacing (int)
	Set the spacing between plot components

int	spacing () const
	Get the spacing between plot components

void	setLegendPosition (QwtPlot::LegendPosition pos, double ratio)
	Set the legend position with a specified ratio

void	setLegendPosition (QwtPlot::LegendPosition pos)
	Set the legend position

QwtPlot::LegendPosition	legendPosition () const
	Get the legend position

void	setLegendRatio (double ratio)
	Set the relative size of the legend in the plot

double	legendRatio () const
	Get the relative size of the legend in the plot

virtual QSize	minimumSizeHint (const QwtPlot *) const
	Calculate the minimum size hint for the plot

virtual void	activate (const QwtPlot *plot, const QRectF &plotRect, Options options=Options())
	Recalculate the geometry of all plot components

virtual void	invalidate ()
	Invalidate the geometry of all components

QRectF	titleRect () const
	Get the geometry for the title

QRectF	footerRect () const
	Get the geometry for the footer

QRectF	legendRect () const
	Get the geometry for the legend

QRectF	scaleRect (QwtAxisId) const
	Get the geometry for a scale axis

QRectF	canvasRect () const
	Get the geometry for the canvas

Protected 成员函数
void	setTitleRect (const QRectF &)
	Set the geometry for the title

void	setFooterRect (const QRectF &)
	Set the geometry for the footer

void	setLegendRect (const QRectF &)
	Set the geometry for the legend

void	setScaleRect (QwtAxisId, const QRectF &)
	Set the geometry for an axis

void	setCanvasRect (const QRectF &)
	Set the geometry for the canvas

QwtPlotLayoutEngine *	layoutEngine ()

void	doActivate (const QwtPlot *plot, const QRectF &plotRect, Options options=Options())
	Concrete implementation of QwtPlotLayout::activate

详细描述

Layout engine for QwtPlot

It is used by the QwtPlot widget to organize its internal widgets or by QwtPlot::print() to render its content to a QPaintDevice like a QPrinter, QPixmap/QImage or QSvgRenderer.

参见: QwtPlot::setPlotLayout()

成员枚举类型说明

◆ Option

enum QwtPlotLayout::Option

Options to configure the plot layout engine

参见: activate(), QwtPlotRenderer

枚举值
AlignScales	Unused
IgnoreScrollbars	Ignore the dimension of the scrollbars. There are no scrollbars when the plot is not rendered to widgets.
IgnoreFrames	Ignore all frames
IgnoreLegend	Ignore the legend
IgnoreTitle	Ignore the title
IgnoreFooter	Ignore the footer

构造及析构函数说明

◆ QwtPlotLayout()

QwtPlotLayout::QwtPlotLayout ( )

explicit

Constructor

Creates a new QwtPlotLayout instance with default settings. The legend position is set to BottomLegend and canvas margin is set to -1.

Destructor

Destroys the QwtPlotLayout instance and releases all allocated resources.

成员函数说明

◆ activate()

void QwtPlotLayout::activate	(	const QwtPlot *	plot,
		const QRectF &	plotRect,
		Options	options = `Options()`
	)

virtual

Recalculate the geometry of all plot components

参数

plot	The plot widget to layout
plotRect	The rectangle where to place the components (in pixels)
options	Layout options (e.g., ignore legend, ignore specific axes)

Calculates and stores the geometry for all sub-components (title, footer, legend, 4 axes, and canvas). Results are stored internally and can be retrieved via titleRect(), footerRect(), legendRect(), canvasRect(), and scaleRect().

参见: invalidate(), titleRect(), footerRect(), legendRect(), scaleRect(), canvasRect()

被 QwtParasitePlotLayout 重载.

◆ alignCanvasToScale()

bool QwtPlotLayout::alignCanvasToScale ( int axisPos ) const

Get the align-canvas-to-axis-scales setting for a specific axis

参数

axisPos Axis position (QwtAxis::Position)

返回: True if canvas is aligned to scale ends, false if it extends beyond

参见: setAlignCanvasToScale(), setAlignCanvasToScales(), setCanvasMargin()

◆ canvasMargin()

int QwtPlotLayout::canvasMargin ( int axisPos ) const

Get the canvas margin for a specific axis position

参数

axisPos Axis position (QwtAxis::Position)

返回: The margin around the scale tick borders for the specified axis

参见: setCanvasMargin()

◆ canvasRect()

QRectF QwtPlotLayout::canvasRect ( ) const

Get the geometry for the canvas

返回: The canvas rectangle

参见: activate(), invalidate(), setCanvasRect()

◆ doActivate()

void QwtPlotLayout::doActivate	(	const QwtPlot *	plot,
		const QRectF &	plotRect,
		Options	options = `Options()`
	)

protected

Concrete implementation of QwtPlotLayout::activate

参数

plotRect
options

◆ footerRect()

QRectF QwtPlotLayout::footerRect ( ) const

Get the geometry for the footer

返回: The footer rectangle

参见: activate(), invalidate(), setFooterRect()

◆ invalidate()

void QwtPlotLayout::invalidate ( )

virtual

Invalidate the geometry of all components

Resets all geometry rectangles (title, footer, legend, canvas, and scales) to empty rectangles. Must call activate() to recalculate geometries.

参见: activate()

◆ legendPosition()

QwtPlot::LegendPosition QwtPlotLayout::legendPosition ( ) const

Get the legend position

返回: The current legend position

参见: setLegendPosition(), QwtPlot::setLegendPosition(), QwtPlot::legendPosition()

◆ legendRatio()

double QwtPlotLayout::legendRatio ( ) const

Get the relative size of the legend in the plot

返回: The legend ratio value

参见: setLegendRatio(), setLegendPosition()

◆ legendRect()

QRectF QwtPlotLayout::legendRect ( ) const

Get the geometry for the legend

返回: The legend rectangle

参见: activate(), invalidate(), setLegendRect()

◆ minimumSizeHint()

QSize QwtPlotLayout::minimumSizeHint ( const QwtPlot * plot ) const

virtual

Calculate the minimum size hint for the plot

参数

plot	The plot widget to calculate size hint for

返回: The minimum size hint

参见: QwtPlot::minimumSizeHint()

被 QwtParasitePlotLayout 重载.

◆ scaleRect()

QRectF QwtPlotLayout::scaleRect ( QwtAxisId axisId ) const

Get the geometry for a scale axis

参数

axisId Axis identifier

返回: The scale rectangle for the specified axis, or empty QRectF if invalid

参见: activate(), invalidate(), setScaleRect()

◆ setAlignCanvasToScale()

void QwtPlotLayout::setAlignCanvasToScale	(	int	axisPos,
		bool	on
	)

Set the align-canvas-to-axis-scales setting for a specific axis

参数

axisPos	Axis position. This identifies a border of the plot. For example, QwtAxis::YLeft aligns the left end of X-axes.
on	True to align canvas to scales, false to extend beyond scale ends

The canvas may either extend beyond the axis scale ends to maximize its size, or align with the axis scale ends to control its size.

注解: When on is true, canvasMargin() has no effect

参见: setAlignCanvasToScales(), alignCanvasToScale(), setCanvasMargin()

◆ setAlignCanvasToScales()

void QwtPlotLayout::setAlignCanvasToScales ( bool on )

Set the align-canvas-to-axis-scales flag for all axes

参数

on	True to align canvas to scales, false otherwise

参见: setAlignCanvasToScale(), alignCanvasToScale()

◆ setCanvasMargin()

void QwtPlotLayout::setCanvasMargin	(	int	margin,
		int	axisPos = `-1`
	)

Set the canvas margin for a specific axis position

参数

margin	The margin value. A negative margin (-1) excludes scale borders. Positive values add space between scale ticks and canvas edge. 0 means tight against tick marks.
axisPos	Axis position (QwtAxis::Position). Use -1 to apply to all axes.

The margin is the space above/below the scale ticks. When alignCanvasToScale() is true, the margin has no effect.

参见: canvasMargin(), setAlignCanvasToScale()

◆ setCanvasRect()

void QwtPlotLayout::setCanvasRect ( const QRectF & rect )

protected

Set the geometry for the canvas

This method is intended to be used from derived layouts overloading activate()

参见: canvasRect(), activate()

◆ setFooterRect()

void QwtPlotLayout::setFooterRect ( const QRectF & rect )

protected

Set the geometry for the footer

This method is intended to be used from derived layouts overloading activate()

参见: footerRect(), activate()

◆ setLegendPosition() [1/2]

void QwtPlotLayout::setLegendPosition ( QwtPlot::LegendPosition pos )

Set the legend position

参数

pos	The legend position. Valid values are QwtPlot::LeftLegend, QwtPlot::RightLegend, QwtPlot::TopLegend, QwtPlot::BottomLegend.

参见: legendPosition(), QwtPlot::setLegendPosition()

◆ setLegendPosition() [2/2]

void QwtPlotLayout::setLegendPosition	(	QwtPlot::LegendPosition	pos,
		double	ratio
	)

Set the legend position with a specified ratio

参数

pos	The legend position (LeftLegend, RightLegend, TopLegend, BottomLegend)
ratio	Ratio between legend and the bounding rectangle of title, footer, canvas and axes. Limited to (0.0, 1.0]. Values <= 0.0 use defaults. Default vertical/horizontal ratio is 0.33/0.5.

参见: legendPosition(), setLegendRatio(), QwtPlot::setLegendPosition()

◆ setLegendRatio()

void QwtPlotLayout::setLegendRatio ( double ratio )

Set the relative size of the legend in the plot

参数

ratio Ratio between legend and the bounding rectangle of title, footer, canvas and axes. Limited to (0.0, 1.0]. Values <= 0.0 use defaults. Default vertical/horizontal ratio is 0.33/0.5.

参见: legendRatio(), setLegendPosition()

◆ setLegendRect()

void QwtPlotLayout::setLegendRect ( const QRectF & rect )

protected

Set the geometry for the legend

This method is intended to be used from derived layouts overloading activate()

参数

rect	Rectangle for the legend

参见: legendRect(), activate()

◆ setScaleRect()

void QwtPlotLayout::setScaleRect	(	QwtAxisId	axisId,
		const QRectF &	rect
	)

protected

Set the geometry for an axis

This method is intended to be used from derived layouts overloading activate()

参数

axisId	Axis
rect	Rectangle for the scale

参见: scaleRect(), activate()

◆ setSpacing()

void QwtPlotLayout::setSpacing ( int spacing )

Set the spacing between plot components

参数

spacing The spacing value in pixels. Must be >= 0.

参见: spacing(), setCanvasMargin()

◆ setTitleRect()

void QwtPlotLayout::setTitleRect ( const QRectF & rect )

protected

Set the geometry for the title

This method is intended to be used from derived layouts overloading activate()

参见: titleRect(), activate()

◆ spacing()

int QwtPlotLayout::spacing ( ) const

Get the spacing between plot components

返回: The spacing value in pixels

参见: setSpacing(), canvasMargin()

◆ titleRect()

QRectF QwtPlotLayout::titleRect ( ) const

Get the geometry for the title

返回: The title rectangle

参见: activate(), invalidate(), setTitleRect()

该类的文档由以下文件生成:

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

类

Public 类型

Public 成员函数

Protected 成员函数

详细描述

成员枚举类型说明

◆ Option

构造及析构函数说明

◆ QwtPlotLayout()

成员函数说明

◆ activate()

◆ alignCanvasToScale()

◆ canvasMargin()

◆ canvasRect()

◆ doActivate()

◆ footerRect()

◆ invalidate()

◆ legendPosition()

◆ legendRatio()

◆ legendRect()

◆ minimumSizeHint()

◆ scaleRect()

◆ setAlignCanvasToScale()

◆ setAlignCanvasToScales()

◆ setCanvasMargin()

◆ setCanvasRect()

◆ setFooterRect()

◆ setLegendPosition() [1/2]

◆ setLegendPosition() [2/2]

◆ setLegendRatio()

◆ setLegendRect()

◆ setScaleRect()

◆ setSpacing()

◆ setTitleRect()

◆ spacing()

◆ titleRect()