Specialized axis ticker which allows arbitrary labels at specified coordinates. More...

#include <qcustomplot.h>

Inheritance diagram for QCPAxisTickerText:

Public Member Functions
	QCPAxisTickerText ()

QMap< double, QString > &	ticks ()

int	subTickCount () const

void	setTicks (const QMap< double, QString > &ticks)

void	setTicks (const QVector< double > &positions, const QVector< QString > labels)

void	setSubTickCount (int subTicks)

void	clear ()

void	addTick (double position, QString label)

void	addTicks (const QMap< double, QString > &ticks)

void	addTicks (const QVector< double > &positions, const QVector< QString > &labels)

	QCPAxisTickerText ()

QMap< double, QString > &	ticks ()

int	subTickCount () const

void	setTicks (const QMap< double, QString > &ticks)

void	setTicks (const QVector< double > &positions, const QVector< QString > labels)

void	setSubTickCount (int subTicks)

void	clear ()

void	addTick (double position, QString label)

void	addTicks (const QMap< double, QString > &ticks)

void	addTicks (const QVector< double > &positions, const QVector< QString > &labels)

	QCPAxisTickerText ()

QMap< double, QString > &	ticks ()

int	subTickCount () const

void	setTicks (const QMap< double, QString > &ticks)

void	setTicks (const QVector< double > &positions, const QVector< QString > labels)

void	setSubTickCount (int subTicks)

void	clear ()

void	addTick (double position, QString label)

void	addTicks (const QMap< double, QString > &ticks)

void	addTicks (const QVector< double > &positions, const QVector< QString > &labels)

	QCPAxisTickerText ()

QMap< double, QString > &	ticks ()

int	subTickCount () const

void	setTicks (const QMap< double, QString > &ticks)

void	setTicks (const QVector< double > &positions, const QVector< QString > labels)

void	setSubTickCount (int subTicks)

void	clear ()

void	addTick (double position, QString label)

void	addTicks (const QMap< double, QString > &ticks)

void	addTicks (const QVector< double > &positions, const QVector< QString > &labels)

	QCPAxisTickerText ()

QMap< double, QString > &	ticks ()

int	subTickCount () const

void	setTicks (const QMap< double, QString > &ticks)

void	setTicks (const QVector< double > &positions, const QVector< QString > labels)

void	setSubTickCount (int subTicks)

void	clear ()

void	addTick (double position, QString label)

void	addTicks (const QMap< double, QString > &ticks)

void	addTicks (const QVector< double > &positions, const QVector< QString > &labels)

Public Member Functions inherited from QCPAxisTicker
	QCPAxisTicker ()

virtual	~QCPAxisTicker ()

TickStepStrategy	tickStepStrategy () const

int	tickCount () const

double	tickOrigin () const

void	setTickStepStrategy (TickStepStrategy strategy)

void	setTickCount (int count)

void	setTickOrigin (double origin)

virtual void	generate (const QCPRange &range, const QLocale &locale, QChar formatChar, int precision, QVector< double > &ticks, QVector< double > subTicks, QVector< QString > tickLabels)

	QCPAxisTicker ()

virtual	~QCPAxisTicker ()

TickStepStrategy	tickStepStrategy () const

int	tickCount () const

double	tickOrigin () const

void	setTickStepStrategy (TickStepStrategy strategy)

void	setTickCount (int count)

void	setTickOrigin (double origin)

virtual void	generate (const QCPRange &range, const QLocale &locale, QChar formatChar, int precision, QVector< double > &ticks, QVector< double > subTicks, QVector< QString > tickLabels)

	QCPAxisTicker ()

virtual	~QCPAxisTicker ()

TickStepStrategy	tickStepStrategy () const

int	tickCount () const

double	tickOrigin () const

void	setTickStepStrategy (TickStepStrategy strategy)

void	setTickCount (int count)

void	setTickOrigin (double origin)

virtual void	generate (const QCPRange &range, const QLocale &locale, QChar formatChar, int precision, QVector< double > &ticks, QVector< double > subTicks, QVector< QString > tickLabels)

	QCPAxisTicker ()

virtual	~QCPAxisTicker ()

TickStepStrategy	tickStepStrategy () const

int	tickCount () const

double	tickOrigin () const

void	setTickStepStrategy (TickStepStrategy strategy)

void	setTickCount (int count)

void	setTickOrigin (double origin)

virtual void	generate (const QCPRange &range, const QLocale &locale, QChar formatChar, int precision, QVector< double > &ticks, QVector< double > subTicks, QVector< QString > tickLabels)

	QCPAxisTicker ()

virtual	~QCPAxisTicker ()

TickStepStrategy	tickStepStrategy () const

int	tickCount () const

double	tickOrigin () const

void	setTickStepStrategy (TickStepStrategy strategy)

void	setTickCount (int count)

void	setTickOrigin (double origin)

virtual void	generate (const QCPRange &range, const QLocale &locale, QChar formatChar, int precision, QVector< double > &ticks, QVector< double > subTicks, QVector< QString > tickLabels)

Protected Member Functions
virtual double	getTickStep (const QCPRange &range) Q_DECL_OVERRIDE

virtual int	getSubTickCount (double tickStep) Q_DECL_OVERRIDE

virtual QString	getTickLabel (double tick, const QLocale &locale, QChar formatChar, int precision) Q_DECL_OVERRIDE

virtual QVector< double >	createTickVector (double tickStep, const QCPRange &range) Q_DECL_OVERRIDE

virtual double	getTickStep (const QCPRange &range) Q_DECL_OVERRIDE

virtual int	getSubTickCount (double tickStep) Q_DECL_OVERRIDE

virtual QString	getTickLabel (double tick, const QLocale &locale, QChar formatChar, int precision) Q_DECL_OVERRIDE

virtual QVector< double >	createTickVector (double tickStep, const QCPRange &range) Q_DECL_OVERRIDE

virtual double	getTickStep (const QCPRange &range) Q_DECL_OVERRIDE

virtual int	getSubTickCount (double tickStep) Q_DECL_OVERRIDE

virtual QString	getTickLabel (double tick, const QLocale &locale, QChar formatChar, int precision) Q_DECL_OVERRIDE

virtual QVector< double >	createTickVector (double tickStep, const QCPRange &range) Q_DECL_OVERRIDE

virtual double	getTickStep (const QCPRange &range) Q_DECL_OVERRIDE

virtual int	getSubTickCount (double tickStep) Q_DECL_OVERRIDE

virtual QString	getTickLabel (double tick, const QLocale &locale, QChar formatChar, int precision) Q_DECL_OVERRIDE

virtual QVector< double >	createTickVector (double tickStep, const QCPRange &range) Q_DECL_OVERRIDE

virtual double	getTickStep (const QCPRange &range) Q_DECL_OVERRIDE

virtual int	getSubTickCount (double tickStep) Q_DECL_OVERRIDE

virtual QString	getTickLabel (double tick, const QLocale &locale, QChar formatChar, int precision) Q_DECL_OVERRIDE

virtual QVector< double >	createTickVector (double tickStep, const QCPRange &range) Q_DECL_OVERRIDE

Protected Member Functions inherited from QCPAxisTicker
virtual QVector< double >	createSubTickVector (int subTickCount, const QVector< double > &ticks)

virtual QVector< QString >	createLabelVector (const QVector< double > &ticks, const QLocale &locale, QChar formatChar, int precision)

void	trimTicks (const QCPRange &range, QVector< double > &ticks, bool keepOneOutlier) const

double	pickClosest (double target, const QVector< double > &candidates) const

double	getMantissa (double input, double *magnitude=0) const

double	cleanMantissa (double input) const

virtual QVector< double >	createSubTickVector (int subTickCount, const QVector< double > &ticks)

virtual QVector< QString >	createLabelVector (const QVector< double > &ticks, const QLocale &locale, QChar formatChar, int precision)

void	trimTicks (const QCPRange &range, QVector< double > &ticks, bool keepOneOutlier) const

double	pickClosest (double target, const QVector< double > &candidates) const

double	getMantissa (double input, double *magnitude=0) const

double	cleanMantissa (double input) const

virtual QVector< double >	createSubTickVector (int subTickCount, const QVector< double > &ticks)

virtual QVector< QString >	createLabelVector (const QVector< double > &ticks, const QLocale &locale, QChar formatChar, int precision)

void	trimTicks (const QCPRange &range, QVector< double > &ticks, bool keepOneOutlier) const

double	pickClosest (double target, const QVector< double > &candidates) const

double	getMantissa (double input, double *magnitude=0) const

double	cleanMantissa (double input) const

virtual QVector< double >	createSubTickVector (int subTickCount, const QVector< double > &ticks)

virtual QVector< QString >	createLabelVector (const QVector< double > &ticks, const QLocale &locale, QChar formatChar, int precision)

void	trimTicks (const QCPRange &range, QVector< double > &ticks, bool keepOneOutlier) const

double	pickClosest (double target, const QVector< double > &candidates) const

double	getMantissa (double input, double *magnitude=0) const

double	cleanMantissa (double input) const

virtual QVector< double >	createSubTickVector (int subTickCount, const QVector< double > &ticks)

virtual QVector< QString >	createLabelVector (const QVector< double > &ticks, const QLocale &locale, QChar formatChar, int precision)

void	trimTicks (const QCPRange &range, QVector< double > &ticks, bool keepOneOutlier) const

double	pickClosest (double target, const QVector< double > &candidates) const

double	getMantissa (double input, double *magnitude=0) const

double	cleanMantissa (double input) const

Protected Attributes
QMap< double, QString >	mTicks

int	mSubTickCount

Protected Attributes inherited from QCPAxisTicker
TickStepStrategy	mTickStepStrategy

int	mTickCount

double	mTickOrigin

Additional Inherited Members
Public Types inherited from QCPAxisTicker
enum	TickStepStrategy { tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount }

enum	TickStepStrategy { tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount }

enum	TickStepStrategy { tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount }

enum	TickStepStrategy { tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount }

enum	TickStepStrategy { tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount }

Detailed Description

Specialized axis ticker which allows arbitrary labels at specified coordinates.

This QCPAxisTicker subclass generates ticks which can be directly specified by the user as coordinates and associated strings. They can be passed as a whole with setTicks or one at a time with addTick. Alternatively you can directly access the internal storage via ticks and modify the tick/label data there.

This is useful for cases where the axis represents categories rather than numerical values.

If you are updating the ticks of this ticker regularly and in a dynamic fasion (e.g. dependent on the axis range), it is a sign that you should probably create an own ticker by subclassing QCPAxisTicker, instead of using this one.

The ticker can be created and assigned to an axis like this:

Constructor & Destructor Documentation

QCPAxisTickerText::QCPAxisTickerText ( )

Constructs the ticker and sets reasonable default values. Axis tickers are commonly created managed by a QSharedPointer, which then can be passed to QCPAxis::setTicker.

QCPAxisTickerText::QCPAxisTickerText ( )

Member Function Documentation

void QCPAxisTickerText::addTick	(	double	position,
		QString	label
	)

Adds a single tick to the axis at the given axis coordinate position, with the provided tick label.

See Also: addTicks, setTicks, clear

void QCPAxisTickerText::addTick	(	double	position,
		QString	label
	)

void QCPAxisTickerText::addTick	(	double	position,
		QString	label
	)

void QCPAxisTickerText::addTick	(	double	position,
		QString	label
	)

void QCPAxisTickerText::addTick	(	double	position,
		QString	label
	)

void QCPAxisTickerText::addTicks ( const QMap< double, QString > & ticks )

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Adds the provided ticks to the ones already existing. The map key of ticks corresponds to the axis coordinate, and the map value is the string that will appear as tick label.

An alternative to manipulate ticks is to directly access the internal storage with the ticks getter.

See Also: addTick, setTicks, clear

void QCPAxisTickerText::addTicks ( const QMap< double, QString > & ticks )

void QCPAxisTickerText::addTicks	(	const QVector< double > &	positions,
		const QVector< QString > &	labels
	)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Adds the provided ticks to the ones already existing. The entries of positions correspond to the axis coordinates, and the entries of labels are the respective strings that will appear as tick labels.

An alternative to manipulate ticks is to directly access the internal storage with the ticks getter.

See Also: addTick, setTicks, clear

void QCPAxisTickerText::addTicks	(	const QVector< double > &	positions,
		const QVector< QString > &	labels
	)

void QCPAxisTickerText::addTicks	(	const QVector< double > &	positions,
		const QVector< QString > &	labels
	)

void QCPAxisTickerText::addTicks	(	const QVector< double > &	positions,
		const QVector< QString > &	labels
	)

void QCPAxisTickerText::addTicks	(	const QVector< double > &	positions,
		const QVector< QString > &	labels
	)

void QCPAxisTickerText::clear ( )

Clears all ticks.

An alternative to manipulate ticks is to directly access the internal storage with the ticks getter.

See Also: setTicks, addTicks, addTick

void QCPAxisTickerText::clear ( )

virtual QVector<double> QCPAxisTickerText::createTickVector	(	double	tickStep,
		const QCPRange &	range
	)

protectedvirtual

Reimplemented from QCPAxisTicker.

virtual QVector<double> QCPAxisTickerText::createTickVector	(	double	tickStep,
		const QCPRange &	range
	)

protectedvirtual

Reimplemented from QCPAxisTicker.

QVector< double > QCPAxisTickerText::createTickVector	(	double	tickStep,
		const QCPRange &	range
	)

protectedvirtual

Returns the externally provided tick coordinates which are in the specified range. If available, one tick above and below the range is provided in addition, to allow possible sub tick calculation. The parameter tickStep is ignored.

Reimplemented from QCPAxisTicker.

virtual QVector<double> QCPAxisTickerText::createTickVector	(	double	tickStep,
		const QCPRange &	range
	)

protectedvirtual

Reimplemented from QCPAxisTicker.

virtual QVector<double> QCPAxisTickerText::createTickVector	(	double	tickStep,
		const QCPRange &	range
	)

protectedvirtual

Reimplemented from QCPAxisTicker.

virtual int QCPAxisTickerText::getSubTickCount ( double tickStep )

protectedvirtual

Reimplemented from QCPAxisTicker.

int QCPAxisTickerText::getSubTickCount ( double tickStep )

protectedvirtual

Returns the sub tick count that was configured with setSubTickCount.

Reimplemented from QCPAxisTicker.

virtual int QCPAxisTickerText::getSubTickCount ( double tickStep )

protectedvirtual

Reimplemented from QCPAxisTicker.

virtual int QCPAxisTickerText::getSubTickCount ( double tickStep )

protectedvirtual

Reimplemented from QCPAxisTicker.

virtual int QCPAxisTickerText::getSubTickCount ( double tickStep )

protectedvirtual

Reimplemented from QCPAxisTicker.

virtual QString QCPAxisTickerText::getTickLabel	(	double	tick,
		const QLocale &	locale,
		QChar	formatChar,
		int	precision
	)

protectedvirtual

Reimplemented from QCPAxisTicker.

virtual QString QCPAxisTickerText::getTickLabel	(	double	tick,
		const QLocale &	locale,
		QChar	formatChar,
		int	precision
	)

protectedvirtual

Reimplemented from QCPAxisTicker.

virtual QString QCPAxisTickerText::getTickLabel	(	double	tick,
		const QLocale &	locale,
		QChar	formatChar,
		int	precision
	)

protectedvirtual

Reimplemented from QCPAxisTicker.

virtual QString QCPAxisTickerText::getTickLabel	(	double	tick,
		const QLocale &	locale,
		QChar	formatChar,
		int	precision
	)

protectedvirtual

Reimplemented from QCPAxisTicker.

QString QCPAxisTickerText::getTickLabel	(	double	tick,
		const QLocale &	locale,
		QChar	formatChar,
		int	precision
	)

protectedvirtual

Returns the tick label which corresponds to the key tick in the internal tick storage. Since the labels are provided externally, locale, formatChar, and precision are ignored.

Reimplemented from QCPAxisTicker.

virtual double QCPAxisTickerText::getTickStep ( const QCPRange & range )

protectedvirtual

Reimplemented from QCPAxisTicker.

virtual double QCPAxisTickerText::getTickStep ( const QCPRange & range )

protectedvirtual

Reimplemented from QCPAxisTicker.

double QCPAxisTickerText::getTickStep ( const QCPRange & range )

protectedvirtual

Since the tick coordinates are provided externally, this method implementation does nothing.

Reimplemented from QCPAxisTicker.

virtual double QCPAxisTickerText::getTickStep ( const QCPRange & range )

protectedvirtual

Reimplemented from QCPAxisTicker.

virtual double QCPAxisTickerText::getTickStep ( const QCPRange & range )

protectedvirtual

Reimplemented from QCPAxisTicker.

void QCPAxisTickerText::setSubTickCount ( int subTicks )

Sets the number of sub ticks that shall appear between ticks. For QCPAxisTickerText, there is no automatic sub tick count calculation. So if sub ticks are needed, they must be configured with this method.

void QCPAxisTickerText::setSubTickCount ( int subTicks )

void QCPAxisTickerText::setTicks ( const QMap< double, QString > & ticks )

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Sets the ticks that shall appear on the axis. The map key of ticks corresponds to the axis coordinate, and the map value is the string that will appear as tick label.

An alternative to manipulate ticks is to directly access the internal storage with the ticks getter.

See Also: addTicks, addTick, clear

void QCPAxisTickerText::setTicks ( const QMap< double, QString > & ticks )

void QCPAxisTickerText::setTicks	(	const QVector< double > &	positions,
		const QVector< QString >	labels
	)

void QCPAxisTickerText::setTicks	(	const QVector< double > &	positions,
		const QVector< QString >	labels
	)

void QCPAxisTickerText::setTicks	(	const QVector< double > &	positions,
		const QVector< QString >	labels
	)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Sets the ticks that shall appear on the axis. The entries of positions correspond to the axis coordinates, and the entries of labels are the respective strings that will appear as tick labels.

See Also: addTicks, addTick, clear

void QCPAxisTickerText::setTicks	(	const QVector< double > &	positions,
		const QVector< QString >	labels
	)

void QCPAxisTickerText::setTicks	(	const QVector< double > &	positions,
		const QVector< QString >	labels
	)