Qwt User's Guide  6.0.2
Public Types | Public Member Functions | Protected Member Functions
QwtPlotMarker Class Reference

#include <qwt_plot_marker.h>

Inheritance diagram for QwtPlotMarker:
Inheritance graph
[legend]

List of all members.

Public Types

enum  LineStyle {
  NoLine,
  HLine,
  VLine,
  Cross
}
- Public Types inherited from QwtPlotItem
enum  ItemAttribute {
  Legend = 0x01,
  AutoScale = 0x02
}
typedef QFlags< ItemAttributeItemAttributes
enum  RenderHint { RenderAntialiased = 1 }
typedef QFlags< RenderHintRenderHints
enum  RttiValues {
  Rtti_PlotItem = 0,
  Rtti_PlotGrid,
  Rtti_PlotScale,
  Rtti_PlotMarker,
  Rtti_PlotCurve,
  Rtti_PlotSpectroCurve,
  Rtti_PlotIntervalCurve,
  Rtti_PlotHistogram,
  Rtti_PlotSpectrogram,
  Rtti_PlotSVG,
  Rtti_PlotUserItem = 1000
}

Public Member Functions

 QwtPlotMarker ()
virtual ~QwtPlotMarker ()
virtual QRectF boundingRect () const
virtual void draw (QPainter *p, const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &) const
virtual void drawLegendIdentifier (QPainter *, const QRectF &) const
QwtText label () const
Qt::Alignment labelAlignment () const
Qt::Orientation labelOrientation () const
const QPen & linePen () const
LineStyle lineStyle () const
virtual int rtti () const
void setLabel (const QwtText &)
void setLabelAlignment (Qt::Alignment)
void setLabelOrientation (Qt::Orientation)
void setLinePen (const QPen &p)
void setLineStyle (LineStyle st)
void setSpacing (int)
void setSymbol (const QwtSymbol *)
void setValue (double, double)
void setValue (const QPointF &)
void setXValue (double)
void setYValue (double)
int spacing () const
const QwtSymbolsymbol () const
virtual void updateLegend (QwtLegend *) const
QPointF value () const
double xValue () const
double yValue () const
- Public Member Functions inherited from QwtPlotItem
 QwtPlotItem (const QwtText &title=QwtText())
virtual ~QwtPlotItem ()
void attach (QwtPlot *plot)
void detach ()
void hide ()
bool isVisible () const
virtual void itemChanged ()
virtual QWidget * legendItem () const
QRectF paintRect (const QwtScaleMap &, const QwtScaleMap &) const
QwtPlotplot () const
QRectF scaleRect (const QwtScaleMap &, const QwtScaleMap &) const
void setAxes (int xAxis, int yAxis)
void setItemAttribute (ItemAttribute, bool on=true)
void setRenderHint (RenderHint, bool on=true)
void setTitle (const QString &title)
void setTitle (const QwtText &title)
virtual void setVisible (bool)
void setXAxis (int axis)
void setYAxis (int axis)
void setZ (double z)
void show ()
bool testItemAttribute (ItemAttribute) const
bool testRenderHint (RenderHint) const
const QwtTexttitle () const
virtual void updateScaleDiv (const QwtScaleDiv &, const QwtScaleDiv &)
int xAxis () const
int yAxis () const
double z () const
- Public Member Functions inherited from QwtLegendItemManager
 QwtLegendItemManager ()
virtual ~QwtLegendItemManager ()

Protected Member Functions

virtual void drawLabel (QPainter *, const QRectF &, const QPointF &) const
virtual void drawLines (QPainter *, const QRectF &, const QPointF &) const

Detailed Description

A class for drawing markers.

A marker can be a horizontal line, a vertical line, a symbol, a label or any combination of them, which can be drawn around a center point inside a bounding rectangle.

The QwtPlotMarker::setSymbol() member assigns a symbol to the marker. The symbol is drawn at the specified point.

With setLabel(), a label can be assigned to the marker. The setLabelAlignment() member specifies where the label is drawn. All the Align*-constants in Qt::AlignmentFlags (see Qt documentation) are valid. The interpretation of the alignment depends on the marker's line style. The alignment refers to the center point of the marker, which means, for example, that the label would be printed left above the center point if the alignment was set to Qt::AlignLeft | Qt::AlignTop.


Member Enumeration Documentation

Line styles.

See also:
setLineStyle(), lineStyle()
Enumerator:
NoLine 

No line.

HLine 

A horizontal line.

VLine 

A vertical line.

Cross 

A crosshair.


Member Function Documentation

QRectF QwtPlotMarker::boundingRect ( ) const
virtual
Returns:
An invalid bounding rect: QRectF(1.0, 1.0, -2.0, -2.0)
Note:
A width or height < 0.0 is ignored by the autoscaler

Reimplemented from QwtPlotItem.

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

Draw the marker

Parameters:
painterPainter
xMapx Scale Map
yMapy Scale Map
canvasRectContents rect of the canvas in painter coordinates

Implements QwtPlotItem.

void QwtPlotMarker::drawLabel ( QPainter *  painter,
const QRectF &  canvasRect,
const QPointF &  pos 
) const
protectedvirtual

Align and draw the text label of the marker

Parameters:
painterPainter
canvasRectContents rect of the canvas in painter coordinates
posPosition of the marker, translated into widget coordinates
See also:
drawLabel(), QwtSymbol::drawSymbol()
void QwtPlotMarker::drawLegendIdentifier ( QPainter *  painter,
const QRectF &  rect 
) const
virtual

Draw the identifier representing the marker on the legend.

Parameters:
painterPainter
rectBounding rectangle for the identifier
See also:
updateLegend(), QwtPlotItem::Legend

Reimplemented from QwtLegendItemManager.

void QwtPlotMarker::drawLines ( QPainter *  painter,
const QRectF &  canvasRect,
const QPointF &  pos 
) const
protectedvirtual

Draw the lines marker

Parameters:
painterPainter
canvasRectContents rect of the canvas in painter coordinates
posPosition of the marker, translated into widget coordinates
See also:
drawLabel(), QwtSymbol::drawSymbol()
QwtText QwtPlotMarker::label ( ) const
Returns:
the label
See also:
setLabel()
Qt::Alignment QwtPlotMarker::labelAlignment ( ) const
Returns:
the label alignment
See also:
setLabelAlignment(), setLabelOrientation()
Qt::Orientation QwtPlotMarker::labelOrientation ( ) const
Returns:
the label orientation
See also:
setLabelOrientation(), labelAlignment()
const QPen & QwtPlotMarker::linePen ( ) const
Returns:
the line pen
See also:
setLinePen()
QwtPlotMarker::LineStyle QwtPlotMarker::lineStyle ( ) const
Returns:
the line style
See also:
setLineStyle()
int QwtPlotMarker::rtti ( ) const
virtual
Returns:
QwtPlotItem::Rtti_PlotMarker

Reimplemented from QwtPlotItem.

void QwtPlotMarker::setLabel ( const QwtText label)

Set the label.

Parameters:
labellabel text
See also:
label()
void QwtPlotMarker::setLabelAlignment ( Qt::Alignment  align)

Set the alignment of the label.

In case of QwtPlotMarker::HLine the alignment is relative to the y position of the marker, but the horizontal flags correspond to the canvas rectangle. In case of QwtPlotMarker::VLine the alignment is relative to the x position of the marker, but the vertical flags correspond to the canvas rectangle.

In all other styles the alignment is relative to the marker's position.

Parameters:
alignAlignment.
See also:
labelAlignment(), labelOrientation()
void QwtPlotMarker::setLabelOrientation ( Qt::Orientation  orientation)

Set the orientation of the label.

When orientation is Qt::Vertical the label is rotated by 90.0 degrees ( from bottom to top ).

Parameters:
orientationOrientation of the label
See also:
labelOrientation(), setLabelAlignment()
void QwtPlotMarker::setLinePen ( const QPen &  pen)

Specify a pen for the line.

Parameters:
penNew pen
See also:
linePen()
void QwtPlotMarker::setLineStyle ( LineStyle  style)

Set the line style.

Parameters:
styleLine style.
See also:
lineStyle()
void QwtPlotMarker::setSpacing ( int  spacing)

Set the spacing.

When the label is not centered on the marker position, the spacing is the distance between the position and the label.

Parameters:
spacingSpacing
See also:
spacing(), setLabelAlignment()
void QwtPlotMarker::setSymbol ( const QwtSymbol symbol)

Assign a symbol.

Parameters:
symbolNew symbol
See also:
symbol()
int QwtPlotMarker::spacing ( ) const
Returns:
the spacing
See also:
setSpacing()
const QwtSymbol * QwtPlotMarker::symbol ( ) const
Returns:
the symbol
See also:
setSymbol(), QwtSymbol
void QwtPlotMarker::updateLegend ( QwtLegend legend) const
virtual

Update the widget that represents the item on the legend.

Parameters:
legendLegend
See also:
drawLegendIdentifier(), legendItem(), itemChanged(), QwtLegend()
Note:
In the default setting QwtPlotItem::Legend is disabled

Reimplemented from QwtPlotItem.