A class for drawing datetime scales. More...

#include <qwt_date_scale_draw.h>

Inheritance diagram for QwtDateScaleDraw:

Classes
class	PrivateData
Public Member Functions
QString	dateFormat (QwtDate::IntervalType) const
virtual QwtText	label (double) const
	Convert a value into its representing label.
	QwtDateScaleDraw (Qt::TimeSpec=Qt::LocalTime)
	Constructor.
void	setDateFormat (QwtDate::IntervalType, const QString &)
void	setTimeSpec (Qt::TimeSpec)
void	setUtcOffset (int seconds)
void	setWeek0Type (QwtDate::Week0Type)
Qt::TimeSpec	timeSpec () const
QDateTime	toDateTime (double) const
int	utcOffset () const
QwtDate::Week0Type	week0Type () const
virtual	~QwtDateScaleDraw ()
	Destructor.
Protected Member Functions
virtual QString	dateFormatOfDate (const QDateTime &, QwtDate::IntervalType) const
virtual QwtDate::IntervalType	intervalType (const QwtScaleDiv &) const
Private Attributes
PrivateData *	d_data

Detailed Description

A class for drawing datetime scales.

QwtDateScaleDraw displays values as datetime labels. The format of the labels depends on the alignment of the major tick labels.

The default format strings are:

Millisecond
"hh:mm:ss:zzz\nddd dd MMM yyyy"
Second
"hh:mm:ss\nddd dd MMM yyyy"
Minute
"hh:mm\nddd dd MMM yyyy"
Hour
"hh:mm\nddd dd MMM yyyy"
Day
"ddd dd MMM yyyy"
Week
"Www yyyy"
Month
"MMM yyyy"
Year
"yyyy"

The format strings can be modified using setDateFormat() or individually for each tick label by overloading dateFormatOfDate(),

Usually QwtDateScaleDraw is used in combination with QwtDateScaleEngine, that calculates scales for datetime intervals.

See also:: QwtDateScaleEngine, QwtPlot::setAxisScaleDraw()

Definition at line 52 of file qwt_date_scale_draw.h.

Constructor & Destructor Documentation

QwtDateScaleDraw::QwtDateScaleDraw ( Qt::TimeSpec timeSpec = Qt::LocalTime ) [explicit]

Constructor.

The default setting is to display tick labels for the given time specification. The first week of a year is defined like for QwtDate::FirstThursday.

Parameters:

timeSpec Time specification

See also:: setTimeSpec(), setWeek0Type()

Definition at line 47 of file qwt_date_scale_draw.cpp.

QwtDateScaleDraw::~QwtDateScaleDraw ( ) [virtual]

Destructor.

Definition at line 53 of file qwt_date_scale_draw.cpp.

Member Function Documentation

QString QwtDateScaleDraw::dateFormat ( QwtDate::IntervalType intervalType ) const

Parameters:

intervalType Interval type

Returns:: Default format string for an datetime interval type

See also:: setDateFormat(), dateFormatOfDate()

Definition at line 151 of file qwt_date_scale_draw.cpp.

QString QwtDateScaleDraw::dateFormatOfDate	(	const QDateTime &	dateTime,
		QwtDate::IntervalType	intervalType
	)		const `[protected, virtual]`

Format string for the representation of a datetime

dateFormatOfDate() is intended to be overloaded for situations, where formats are individual for specific datetime values.

The default setting ignores dateTime and return the default format for the interval type.

Parameters:

dateTime	Datetime value
intervalType	Interval type

Returns:: Format string

See also:: setDateFormat(), QwtDate::toString()

Definition at line 179 of file qwt_date_scale_draw.cpp.

QwtDate::IntervalType QwtDateScaleDraw::intervalType ( const QwtScaleDiv & scaleDiv ) const [protected, virtual]

Find the less detailed datetime unit, where no rounding errors happen.

Parameters:

scaleDiv Scale division

Returns:: Interval type

See also:: dateFormatOfDate()

Definition at line 222 of file qwt_date_scale_draw.cpp.

QwtText QwtDateScaleDraw::label ( double value ) const [virtual]

Convert a value into its representing label.

The value is converted to a datetime value using toDateTime() and converted to a plain text using QwtDate::toString().

Parameters:

value Value

Returns:: Label string.

See also:: dateFormatOfDate()

Reimplemented from QwtAbstractScaleDraw.

Definition at line 204 of file qwt_date_scale_draw.cpp.

void QwtDateScaleDraw::setDateFormat	(	QwtDate::IntervalType	intervalType,
		const QString &	format
	)

Set the default format string for an datetime interval type

Parameters:

intervalType	Interval type
format	Default format string

See also:: dateFormat(), dateFormatOfDate(), QwtDate::toString()

Definition at line 136 of file qwt_date_scale_draw.cpp.

void QwtDateScaleDraw::setTimeSpec ( Qt::TimeSpec timeSpec )

Set the time specification used for the tick labels

Parameters:

timeSpec Time specification

See also:: timeSpec(), setUtcOffset(), toDateTime()

Definition at line 64 of file qwt_date_scale_draw.cpp.

void QwtDateScaleDraw::setUtcOffset ( int seconds )

Set the offset in seconds from Coordinated Universal Time

Parameters:

seconds Offset in seconds

Note:: The offset has no effect beside for the time specification Qt::OffsetFromUTC.

See also:: QDate::utcOffset(), setTimeSpec(), toDateTime()

Definition at line 88 of file qwt_date_scale_draw.cpp.

void QwtDateScaleDraw::setWeek0Type ( QwtDate::Week0Type week0Type )

Sets how to identify the first week of a year.

Parameters:

week0Type Mode how to identify the first week of a year

See also:: week0Type().

Note:: week0Type has no effect beside for intervals classified as QwtDate::Week.

Definition at line 114 of file qwt_date_scale_draw.cpp.

Qt::TimeSpec QwtDateScaleDraw::timeSpec ( ) const

Returns:: Time specification used for the tick labels

See also:: setTimeSpec(), utcOffset(), toDateTime()

Definition at line 73 of file qwt_date_scale_draw.cpp.

QDateTime QwtDateScaleDraw::toDateTime ( double value ) const

Translate a double value into a QDateTime object.

Returns:: QDateTime object initialized with timeSpec() and utcOffset().

See also:: timeSpec(), utcOffset(), QwtDate::toDateTime()

Definition at line 268 of file qwt_date_scale_draw.cpp.

int QwtDateScaleDraw::utcOffset ( ) const

Returns:: Offset in seconds from Coordinated Universal Time

Note:: The offset has no effect beside for the time specification Qt::OffsetFromUTC.

See also:: QDate::setUtcOffset(), setTimeSpec(), toDateTime()

Definition at line 100 of file qwt_date_scale_draw.cpp.

QwtDate::Week0Type QwtDateScaleDraw::week0Type ( ) const

Returns:: Setting how to identify the first week of a year.

See also:: setWeek0Type()

Definition at line 123 of file qwt_date_scale_draw.cpp.

Member Data Documentation

PrivateData* QwtDateScaleDraw::d_data [private]

Reimplemented from QwtScaleDraw.

Definition at line 82 of file qwt_date_scale_draw.h.

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

Classes

Public Member Functions

Protected Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation