QWT API (中文) 7.3.0
Qt绘图库 - 中文API文档
载入中...
搜索中...
未找到
| Public 成员函数 | 所有成员列表
QwtPlotScaleItem类 参考

A class which draws a scale inside the plot canvas 更多...

#include <qwt_plot_scaleitem.h>

类 QwtPlotScaleItem 继承关系图:
QwtPlotItem

class  PrivateData
 

Public 成员函数

 QwtPlotScaleItem (QwtScaleDraw::Alignment=QwtScaleDraw::BottomScale, const double pos=0.0)
 Constructor for scale item at the position pos
 
virtual int rtti () const override
 Get the runtime type information
 
void setScaleDiv (const QwtScaleDiv &)
 Assign a scale division
 
const QwtScaleDivscaleDiv () const
 Get the scale division
 
void setScaleDivFromAxis (bool on)
 Enable/Disable the synchronization of the scale division with the corresponding axis
 
bool isScaleDivFromAxis () const
 Check if synchronization of the scale division with the corresponding axis is enabled
 
void setPalette (const QPalette &)
 Set the palette
 
QPalette palette () const
 Get the palette
 
void setFont (const QFont &)
 Change the tick label font
 
QFont font () const
 Get the tick label font
 
void setScaleDraw (QwtScaleDraw *)
 Set a scale draw
 
const QwtScaleDrawscaleDraw () const
 Get the scale draw (const version)
 
QwtScaleDrawscaleDraw ()
 Get the scale draw
 
void setPosition (double pos)
 Change the position of the scale
 
double position () const
 Get the position of the scale
 
void setBorderDistance (int)
 Align the scale to the canvas
 
int borderDistance () const
 Get the distance from a canvas border
 
void setAlignment (QwtScaleDraw::Alignment)
 Change the alignment of the scale
 
virtual void draw (QPainter *, const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &canvasRect) const override
 Draw the scale
 
virtual void updateScaleDiv (const QwtScaleDiv &, const QwtScaleDiv &) override
 Update the item to changes of the axes scale division
 
- Public 成员函数 继承自 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
 
virtual void attach (QwtPlot *plot)
 Attach the item to a plot
 
void detach ()
 Detach the item from the plot
 
QwtPlotplot () 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 QwtTexttitle () 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 updateLegend (const QwtPlotItem *, const QList< QwtLegendData > &)
 Update the item with changes of the legend
 
QRectF scaleRect (const QwtScaleMap &, const QwtScaleMap &) const
 Calculate the scale rectangle
 
QRectF paintRect (const QwtScaleMap &, const QwtScaleMap &) const
 Calculate the paint rectangle
 
virtual QList< QwtLegendDatalegendData () const
 Return legend data
 
virtual QwtGraphic legendIcon (int index, const QSizeF &) const
 Return a legend icon
 

额外继承的成员函数

- Public 类型 继承自 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 更多...
 
enum  ItemAttribute { Legend = 0x01 , AutoScale = 0x02 , Margins = 0x04 }
 Plot Item Attributes 更多...
 
enum  ItemInterest { ScaleInterest = 0x01 , LegendInterest = 0x02 }
 Plot Item Interests 更多...
 
enum  RenderHint { RenderAntialiased = 0x1 }
 Render hints 更多...
 
- Protected 成员函数 继承自 QwtPlotItem
QwtGraphic defaultIcon (const QBrush &, const QSizeF &) const
 Create a default icon
 

详细描述

A class which draws a scale inside the plot canvas

QwtPlotScaleItem can be used to draw an axis inside the plot canvas. It might be synchronized to one of the axis of the plot, but can also display its own ticks and labels.

It is allowed to synchronize the scale item with a disabled axis. In plots with vertical and horizontal scale items, it might be necessary to remove ticks at the intersections, by overloading updateScaleDiv().

     The scale might be at a specific position (e.g 0.0) or it might be aligned to a canvas border.
Example
The following example shows how to replace the left axis, by a scale item at the x position 0.0.
scaleItem->setFont( plot->axisWidget( QwtAxis::YLeft )->font() );
scaleItem->attach(plot);
QwtPlot * plot() const
Get the plot the item is attached to
Definition qwt_plot_item.cpp:164
virtual void attach(QwtPlot *plot)
Attach the item to a plot
Definition qwt_plot_item.cpp:118
A class which draws a scale inside the plot canvas
Definition qwt_plot_scaleitem.h:58
void setFont(const QFont &)
Change the tick label font
Definition qwt_plot_scaleitem.cpp:208
void setAxisVisible(QwtAxisId, bool on=true)
Hide or show a specified axis
Definition qwt_plot_axis.cpp:462
const QwtScaleWidget * axisWidget(QwtAxisId) const
Return the scale widget of the specified axis
Definition qwt_plot_axis.cpp:176
@ RightScale
The scale is right
Definition qwt_scale_draw.h:70
@ YLeft
Y axis left of the canvas
Definition qwt_axis.h:45

构造及析构函数说明

◆ QwtPlotScaleItem()

QwtPlotScaleItem::QwtPlotScaleItem ( QwtScaleDraw::Alignment  alignment = QwtScaleDraw::BottomScale,
const double  pos = 0.0 
)
explicit

Constructor for scale item at the position pos

参数
[in]alignmentIn case of QwtScaleDraw::BottomScale or QwtScaleDraw::TopScale, the scale item is corresponding to the xAxis(), otherwise it corresponds to the yAxis().
[in]posx or y position, depending on the corresponding axis.
参见
setPosition(), setAlignment()

Destructor

成员函数说明

◆ borderDistance()

int QwtPlotScaleItem::borderDistance ( ) const

Get the distance from a canvas border

返回
Distance from a canvas border
参见
setBorderDistance(), setPosition()

◆ draw()

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

Draw the scale

参数
[in]painterPainter
[in]xMapX Scale Map
[in]yMapY Scale Map
[in]canvasRectContents rectangle of the canvas in painter coordinates

实现了 QwtPlotItem.

◆ font()

QFont QwtPlotScaleItem::font ( ) const

Get the tick label font

返回
Font
参见
setFont()

◆ isScaleDivFromAxis()

bool QwtPlotScaleItem::isScaleDivFromAxis ( ) const

Check if synchronization of the scale division with the corresponding axis is enabled

返回
True, if the synchronization of the scale division with the corresponding axis is enabled.
参见
setScaleDiv(), setScaleDivFromAxis()

◆ palette()

QPalette QwtPlotScaleItem::palette ( ) const

Get the palette

返回
Palette
参见
setPalette()

◆ position()

double QwtPlotScaleItem::position ( ) const

Get the position of the scale

返回
Position of the scale
参见
setPosition(), setAlignment()

◆ rtti()

int QwtPlotScaleItem::rtti ( ) const
overridevirtual

Get the runtime type information

返回
QwtPlotItem::Rtti_PlotScale

重载 QwtPlotItem .

◆ scaleDiv()

const QwtScaleDiv & QwtPlotScaleItem::scaleDiv ( ) const

Get the scale division

返回
Scale division

◆ scaleDraw() [1/2]

QwtScaleDraw * QwtPlotScaleItem::scaleDraw ( )

Get the scale draw

返回
Scale draw
参见
setScaleDraw()

◆ scaleDraw() [2/2]

const QwtScaleDraw * QwtPlotScaleItem::scaleDraw ( ) const

Get the scale draw (const version)

返回
Scale draw
参见
setScaleDraw()

◆ setAlignment()

void QwtPlotScaleItem::setAlignment ( QwtScaleDraw::Alignment  alignment)

Change the alignment of the scale

参数
[in]alignmentAlignment

The alignment sets the orientation of the scale and the position of the ticks:

◆ setBorderDistance()

void QwtPlotScaleItem::setBorderDistance ( int  distance)

Align the scale to the canvas

参数
[in]distanceNumber of pixels between the canvas border and the backbone of the scale.

If distance is >= 0 the scale will be aligned to a border of the contents rectangle of the canvas. If alignment() is QwtScaleDraw::LeftScale, the scale will be aligned to the right border, if it is QwtScaleDraw::TopScale it will be aligned to the bottom (and vice versa). If distance is < 0 the scale will be at the position().

参见
setPosition(), borderDistance()

◆ setFont()

void QwtPlotScaleItem::setFont ( const QFont &  font)

Change the tick label font

参数
[in]fontFont
参见
font()

◆ setPalette()

void QwtPlotScaleItem::setPalette ( const QPalette &  palette)

Set the palette

参数
[in]palettePalette
参见
QwtAbstractScaleDraw::draw(), palette()

◆ setPosition()

void QwtPlotScaleItem::setPosition ( double  pos)

Change the position of the scale

参数
[in]posNew position

The position is interpreted as y value for horizontal axes and as x value for vertical axes. The border distance is set to -1.

参见
position(), setAlignment()

◆ setScaleDiv()

void QwtPlotScaleItem::setScaleDiv ( const QwtScaleDiv scaleDiv)

Assign a scale division

参数
[in]scaleDivScale division

When assigning a scaleDiv the scale division won't be synchronized with the corresponding axis anymore.

参见
scaleDiv(), setScaleDivFromAxis(), isScaleDivFromAxis()

◆ setScaleDivFromAxis()

void QwtPlotScaleItem::setScaleDivFromAxis ( bool  on)

Enable/Disable the synchronization of the scale division with the corresponding axis

参数
[in]ontrue/false
参见
isScaleDivFromAxis()

◆ setScaleDraw()

void QwtPlotScaleItem::setScaleDraw ( QwtScaleDraw scaleDraw)

Set a scale draw

参数
[in]scaleDrawObject responsible for drawing scales

The main use case for replacing the default QwtScaleDraw is to overload QwtAbstractScaleDraw::label, to replace or swallow tick labels.

参见
scaleDraw()

◆ updateScaleDiv()

void QwtPlotScaleItem::updateScaleDiv ( const QwtScaleDiv xScaleDiv,
const QwtScaleDiv yScaleDiv 
)
overridevirtual

Update the item to changes of the axes scale division

参数
[in]xScaleDivScale division of the x-axis
[in]yScaleDivScale division of the y-axis

In case of isScaleDivFromAxis(), the scale draw is synchronized to the correspond axis.

参见
QwtPlot::updateAxes()

重载 QwtPlotItem .


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