KDGantt::DateTimeGrid Class Reference

#include <kdganttdatetimegrid.h>

Inheritance diagram for KDGantt::DateTimeGrid:

[legend]

Collaboration diagram for KDGantt::DateTimeGrid:

[legend]

List of all members.

---

Detailed Description

This implementation of AbstractGrid works with QDateTime and shows days and week numbers in the header

Definition at line 69 of file kdganttdatetimegrid.h.

Public Types
enum	Scale {   ScaleAuto,   ScaleHour,   ScaleDay,   ScaleWeek,   ScaleMonth,   ScaleUserDefined }
Public Slots
virtual void	setModel (QAbstractItemModel *model)
virtual void	setRootIndex (const QModelIndex &idx)
Signals
void	gridChanged ()
Public Member Functions
	DateTimeGrid ()
qreal	dayWidth () const
QSet< Qt::DayOfWeek >	freeDays () const
bool	isSatisfiedConstraint (const Constraint &c) const
bool	mapFromChart (const Span &span, const QModelIndex &idx, const QList< Constraint > &constraints=QList< Constraint >()) const
qreal	mapFromDateTime (const QDateTime &dt) const
Span	mapToChart (const QModelIndex &idx) const
QDateTime	mapToDateTime (qreal x) const
QAbstractItemModel *	model () const
QBrush	noInformationBrush () const
void	paintGrid (QPainter *painter, const QRectF &sceneRect, const QRectF &exposedRect, AbstractRowController *rowController=0, QWidget *widget=0)
void	paintHeader (QPainter *painter, const QRectF &headerRect, const QRectF &exposedRect, qreal offset, QWidget *widget=0)
QModelIndex	rootIndex () const
bool	rowSeparators () const
Scale	scale () const
void	setDayWidth (qreal)
void	setFreeDays (const QSet< Qt::DayOfWeek > &fd)
void	setNoInformationBrush (const QBrush &brush)
void	setRowSeparators (bool enable)
void	setScale (Scale s)
void	setStartDateTime (const QDateTime &dt)
void	setUserDefinedLowerScale (DateTimeScaleFormatter *lower)
void	setUserDefinedUpperScale (DateTimeScaleFormatter *upper)
void	setWeekStart (Qt::DayOfWeek)
QDateTime	startDateTime () const
DateTimeScaleFormatter *	userDefinedLowerScale () const
DateTimeScaleFormatter *	userDefinedUpperScale () const
Qt::DayOfWeek	weekStart () const
virtual	~DateTimeGrid ()
Protected Member Functions
virtual void	paintDayScaleHeader (QPainter *painter, const QRectF &headerRect, const QRectF &exposedRect, qreal offset, QWidget *widget=0)
virtual void	paintHourScaleHeader (QPainter *painter, const QRectF &headerRect, const QRectF &exposedRect, qreal offset, QWidget *widget=0)
virtual void	paintMonthScaleHeader (QPainter *painter, const QRectF &headerRect, const QRectF &exposedRect, qreal offset, QWidget *widget=0)
virtual void	paintUserDefinedHeader (QPainter *painter, const QRectF &headerRect, const QRectF &exposedRect, qreal offset, const DateTimeScaleFormatter *formatter, QWidget *widget=0)
virtual void	paintWeekScaleHeader (QPainter *painter, const QRectF &headerRect, const QRectF &exposedRect, qreal offset, QWidget *widget=0)

---

Member Enumeration Documentation

enum KDGantt::DateTimeGrid::Scale

Enumerator:

ScaleAuto
ScaleHour
ScaleDay
ScaleWeek
ScaleMonth
ScaleUserDefined

Definition at line 73 of file kdganttdatetimegrid.h.

                   { ScaleAuto, 
                     ScaleHour,
                     ScaleDay,
                     ScaleWeek,
                     ScaleMonth,
                     ScaleUserDefined
        };

---

Constructor & Destructor Documentation

DateTimeGrid::DateTimeGrid

(

)

Definition at line 287 of file kdganttdatetimegrid.cpp.

                           : AbstractGrid( new Private )
{
}

DateTimeGrid::~DateTimeGrid

(

)

[virtual]

Definition at line 291 of file kdganttdatetimegrid.cpp.

{
}

---

Member Function Documentation

qreal DateTimeGrid::dayWidth

(

)

const

Returns:

The width in pixels for each day in the grid.

The default is 100 pixels.

Definition at line 319 of file kdganttdatetimegrid.cpp.

References d.

Referenced by KDAB_SCOPED_UNITTEST_SIMPLE(), paintDayScaleHeader(), paintGrid(), paintHourScaleHeader(), paintMonthScaleHeader(), and paintWeekScaleHeader().

{
    return d->dayWidth;
}

QSet< Qt::DayOfWeek > DateTimeGrid::freeDays

(

)

const

Returns:

The days marked as free in the grid.

Definition at line 443 of file kdganttdatetimegrid.cpp.

References d.

{
    return d->freeDays;
}

void KDGantt::AbstractGrid::gridChanged

(

)

[signal, inherited]

Referenced by setDayWidth(), setFreeDays(), setNoInformationBrush(), setScale(), setStartDateTime(), setUserDefinedLowerScale(), setUserDefinedUpperScale(), and setWeekStart().

bool AbstractGrid::isSatisfiedConstraint

(

const Constraint &

c

)

const [inherited]

Returns:

true if the startpoint is before the endpoint of the constraint c.

Definition at line 86 of file kdganttabstractgrid.cpp.

References KDGantt::Span::end(), KDGantt::Constraint::endIndex(), KDGantt::AbstractGrid::mapToChart(), and KDGantt::Constraint::startIndex().

Referenced by KDAB_SCOPED_UNITTEST_SIMPLE(), and mapFromChart().

{
    // First check if the data is valid,
    // TODO: review if true is the right choice
    if ( !c.startIndex().isValid() || !c.endIndex().isValid() ) return true;

    Span ss = mapToChart( c.startIndex() );
    Span es = mapToChart( c.endIndex() );
    return ( ss.end() <= es.start() );
}

bool DateTimeGrid::mapFromChart	(	const Span &	span,
		const QModelIndex &	idx,
		const QList< Constraint > &	constraints = QList<Constraint>()
	)			const [virtual]

Maps the supplied Span to QDateTimes, and puts them as start time and end time for the supplied index.

Parameters:

	span	The span used to map from.
	idx	The index used for setting the start time and end time in the model.
	constraints	A list of hard constraints to match against the start time and end time mapped from the span.

Returns:

true if the start time and time was successfully added to the model, or false if unsucessful. Also returns false if any of the constraints isn't satisfied. That is, if the start time of the constrained index is before the end time of the dependency index, or the end time of the constrained index is before the start time of the dependency index.

Implements KDGantt::AbstractGrid.

Definition at line 538 of file kdganttdatetimegrid.cpp.

References c, d, KDGantt::Constraint::endIndex(), KDGantt::EndTimeRole, KDGantt::AbstractGrid::isSatisfiedConstraint(), KDGantt::Span::length(), KDGantt::AbstractGrid::model(), KDGantt::Span::start(), KDGantt::Constraint::startIndex(), KDGantt::StartTimeRole, KDGantt::Constraint::type(), and KDGantt::Constraint::TypeHard.

Referenced by KDAB_SCOPED_UNITTEST_SIMPLE().

{
    assert( model() );
    if ( !idx.isValid() ) return false;
    assert( idx.model()==model() );

    QDateTime st = d->chartXtoDateTime(span.start());
    QDateTime et = d->chartXtoDateTime(span.start()+span.length());
    //qDebug() << "DateTimeGrid::mapFromChart("<<span<<") => "<< st << et;
    Q_FOREACH( const Constraint& c, constraints ) {
        if ( c.type() != Constraint::TypeHard || !isSatisfiedConstraint( c )) continue;
        if ( c.startIndex() == idx ) {
            QDateTime tmpst = model()->data( c.endIndex(), StartTimeRole ).toDateTime();
            //qDebug() << tmpst << "<" << et <<"?";
            if ( tmpst<et ) return false;
        } else if ( c.endIndex() == idx ) {
            QDateTime tmpet = model()->data( c.startIndex(), EndTimeRole ).toDateTime();
            //qDebug() << tmpet << ">" << st <<"?";
            if ( tmpet>st ) return false;
        }
    }
    return model()->setData( idx, qVariantFromValue(st), StartTimeRole )
        && model()->setData( idx, qVariantFromValue(et), EndTimeRole );
}

qreal DateTimeGrid::mapFromDateTime

(

const QDateTime &

dt

)

const

Maps a given point in time dt to an X value in the scene.

Definition at line 326 of file kdganttdatetimegrid.cpp.

References d.

Referenced by KDAB_SCOPED_UNITTEST_SIMPLE().

{
    return d->dateTimeToChartX( dt );
}

Span DateTimeGrid::mapToChart

(

const QModelIndex &

idx

)

const [virtual]

Parameters:

idx

The index to get the Span for.

Returns:

The start and end pixels, in a Span, of the specified index.

Implements KDGantt::AbstractGrid.

Definition at line 479 of file kdganttdatetimegrid.cpp.

References d, KDGantt::EndTimeRole, KDGantt::AbstractGrid::model(), and KDGantt::StartTimeRole.

Referenced by KDAB_SCOPED_UNITTEST_SIMPLE().

{
    assert( model() );
    if ( !idx.isValid() ) return Span();
    assert( idx.model()==model() );
    const QVariant sv = model()->data( idx, StartTimeRole );
    const QVariant ev = model()->data( idx, EndTimeRole );
    if( qVariantCanConvert<QDateTime>(sv) &&
    qVariantCanConvert<QDateTime>(ev) &&
    !(sv.type() == QVariant::String && qVariantValue<QString>(sv).isEmpty()) &&
    !(ev.type() == QVariant::String && qVariantValue<QString>(ev).isEmpty())
    ) {
      QDateTime st = sv.toDateTime();
      QDateTime et = ev.toDateTime();
      if ( et.isValid() && st.isValid() ) {
        qreal sx = d->dateTimeToChartX( st );
        qreal ex = d->dateTimeToChartX( et )-sx;
        //qDebug() << "DateTimeGrid::mapToChart("<<st<<et<<") => "<< Span( sx, ex );
        return Span( sx, ex);
      }
    }
    // Special case for Events with only a start date
    if( qVariantCanConvert<QDateTime>(sv) && !(sv.type() == QVariant::String && qVariantValue<QString>(sv).isEmpty()) ) {
      QDateTime st = sv.toDateTime();
      if ( st.isValid() ) {
        qreal sx = d->dateTimeToChartX( st );
        return Span( sx, 0 );
      }
    }
    return Span();
}

QDateTime DateTimeGrid::mapToDateTime

(

qreal

x

)

const

Maps a given X value x in scene coordinates to a point in time.

Definition at line 333 of file kdganttdatetimegrid.cpp.

References d.

Referenced by KDAB_SCOPED_UNITTEST_SIMPLE().

{
    return d->chartXtoDateTime( x );
}

QAbstractItemModel * AbstractGrid::model

(

)

const [inherited]

Returns:

The QAbstractItemModel used by this grid

Definition at line 64 of file kdganttabstractgrid.cpp.

References d.

Referenced by KDAB_SCOPED_UNITTEST_SIMPLE(), mapFromChart(), and mapToChart().

{
    return d->model;
}

QBrush DateTimeGrid::noInformationBrush

(

)

const

Returns:

the brush used to mark rows with no information.

Definition at line 471 of file kdganttdatetimegrid.cpp.

References d.

{
    return d->noInformationBrush;
}

void DateTimeGrid::paintDayScaleHeader	(	QPainter *	painter,
		const QRectF &	headerRect,
		const QRectF &	exposedRect,
		qreal	offset,
		QWidget *	widget = 0
	)			[protected, virtual]

Paints the day scale header.

See also:

paintHeader()

Definition at line 973 of file kdganttdatetimegrid.cpp.

References d, dayWidth(), and StockDiagram::Private::Private().

Referenced by paintHeader().

{
    class DayFormatter : public Private::DateTextFormatter {
    public:
        QString format( const QDateTime& dt ) {
            return dt.toString( QString::fromAscii( "ddd" ) ).left( 1 );
        }
        QRect textRect( qreal x, qreal offset, qreal dayWidth, const QRectF& headerRect, const QDateTime& dt ) {
            return QRectF( QPointF( x, headerRect.top() ) + QPointF( -offset + 1.0, headerRect.height() / 2.0 ),
                           QSizeF( dayWidth, headerRect.height() / 2.0 ) ).toAlignedRect();
        }
    };
    d->paintHeader( painter, headerRect, exposedRect, offset, widget, // General parameters
                    Private::HeaderDay, new DayFormatter ); // Custom parameters

    class WeekFormatter : public Private::DateTextFormatter {
    public:
        QString format( const QDateTime& dt ) {
            return QString::number( dt.date().weekNumber() );
        }
        QRect textRect( qreal x, qreal offset, qreal dayWidth, const QRectF& headerRect, const QDateTime& dt ) {
            return QRectF( QPointF( x, headerRect.top() ) + QPointF( -offset, 0.0 ),
                           QSizeF( dayWidth * 7, headerRect.height() / 2.0 ) ).toRect();
        }
    };
    d->paintHeader( painter, headerRect, exposedRect, offset, widget, // General parameters
                    Private::HeaderWeek, new WeekFormatter ); // Custom parameters
}

void DateTimeGrid::paintGrid	(	QPainter *	painter,
		const QRectF &	sceneRect,
		const QRectF &	exposedRect,
		AbstractRowController *	rowController = 0,
		QWidget *	widget = 0
	)			[virtual]

Implement this to paint the background of the view -- typically with some grid lines.

Parameters:

	painter	-- the QPainter to paint with.
	sceneRect	-- the total bounding rectangle of the scene.
	exposedRect	-- the rectangle that needs to be painted.
	rowController	-- the row controller used by the view -- may be 0.
	widget	-- the widget used by the view -- may be 0.

Implements KDGantt::AbstractGrid.

Definition at line 703 of file kdganttdatetimegrid.cpp.

References d, dayWidth(), KDGantt::AbstractRowController::indexAbove(), KDGantt::AbstractRowController::indexAt(), KDGantt::AbstractRowController::indexBelow(), KDGantt::ItemTypeRole, KDGantt::Span::length(), KDGantt::AbstractRowController::rowGeometry(), scale(), ScaleAuto, ScaleDay, ScaleHour, ScaleMonth, ScaleUserDefined, ScaleWeek, and KDGantt::Span::start().

{
    // TODO: Support hours and weeks
    switch( scale() ) {
    case ScaleHour:
    case ScaleDay:
    case ScaleWeek:
    case ScaleMonth:
        d->paintVerticalLines( painter, sceneRect, exposedRect, widget, d->headerTypeForScale( scale() ) );
        break;
    case ScaleAuto: {
        const qreal tabw = QApplication::fontMetrics().width( QLatin1String( "XXXXX" ) );
        const qreal dayw = dayWidth();
        if ( dayw > 24*60*60*tabw ) {
            d->paintVerticalUserDefinedLines( painter, sceneRect, exposedRect, &d->minute_lower, widget );
        } else if ( dayw > 24*60*tabw ) {
            d->paintVerticalLines( painter, sceneRect, exposedRect, widget, Private::HeaderHour );
        } else if ( dayw > 24*tabw ) {
        d->paintVerticalLines( painter, sceneRect, exposedRect, widget, Private::HeaderDay );
        } else if ( dayw > tabw ) {
            d->paintVerticalUserDefinedLines( painter, sceneRect, exposedRect, &d->week_lower, widget );
        } else if ( 4*dayw > tabw ) {
            d->paintVerticalUserDefinedLines( painter, sceneRect, exposedRect, &d->month_lower, widget );
        } else {
            d->paintVerticalUserDefinedLines( painter, sceneRect, exposedRect, &d->year_lower, widget );
        }
        break;
    }
    case ScaleUserDefined:
        d->paintVerticalUserDefinedLines( painter, sceneRect, exposedRect, d->lower, widget );
        break;
    }
    if ( rowController ) {
        // First draw the rows
        QPen pen = painter->pen();
        pen.setBrush( QApplication::palette().dark() );
        pen.setStyle( Qt::DashLine );
        painter->setPen( pen );
        QModelIndex idx = rowController->indexAt( qRound( exposedRect.top() ) );
        if ( rowController->indexAbove( idx ).isValid() ) idx = rowController->indexAbove( idx );
        qreal y = 0;
        while ( y < exposedRect.bottom() && idx.isValid() ) {
            const Span s = rowController->rowGeometry( idx );
            y = s.start()+s.length();
            if ( d->rowSeparators ) {
                painter->drawLine( QPointF( sceneRect.left(), y ),
                                   QPointF( sceneRect.right(), y ) );
            }
            if ( !idx.data( ItemTypeRole ).isValid() && d->noInformationBrush.style() != Qt::NoBrush ) {
                painter->fillRect( QRectF( exposedRect.left(), s.start(), exposedRect.width(), s.length() ), d->noInformationBrush );
            }
            // Is alternating background better?
            //if ( idx.row()%2 ) painter->fillRect( QRectF( exposedRect.x(), s.start(), exposedRect.width(), s.length() ), QApplication::palette().alternateBase() );
            idx =  rowController->indexBelow( idx );
        }
    }
}

void DateTimeGrid::paintHeader	(	QPainter *	painter,
		const QRectF &	headerRect,
		const QRectF &	exposedRect,
		qreal	offset,
		QWidget *	widget = 0
	)			[virtual]

Implement this to paint the header part of the view.

Parameters:

	painter	-- the QPainter to paint with.
	headerRect	-- the total rectangle occupied by the header.
	exposedRect	-- the rectangle that needs to be painted.
	offset	-- the horizontal scroll offset of the view.
	widget	-- the widget used by the view -- may be 0.

Implements KDGantt::AbstractGrid.

Definition at line 803 of file kdganttdatetimegrid.cpp.

References d, paintDayScaleHeader(), paintHourScaleHeader(), paintMonthScaleHeader(), paintUserDefinedHeader(), paintWeekScaleHeader(), scale(), ScaleAuto, ScaleDay, ScaleHour, ScaleMonth, ScaleUserDefined, ScaleWeek, startDateTime(), and KDGantt::DateTimeScaleFormatter::text().

{
    painter->save();
    QPainterPath clipPath;
    clipPath.addRect( headerRect );
    painter->setClipPath( clipPath, Qt::IntersectClip );
    switch( scale() )
    {
    case ScaleHour:
        paintHourScaleHeader( painter, headerRect, exposedRect, offset, widget );
        break;
    case ScaleDay:
        paintDayScaleHeader( painter, headerRect, exposedRect, offset, widget );
        break;
    case ScaleWeek:
        paintWeekScaleHeader( painter, headerRect, exposedRect, offset, widget );
        break;
    case ScaleMonth:
        paintMonthScaleHeader( painter, headerRect, exposedRect, offset, widget );
        break;
    case ScaleAuto:
        {
            DateTimeScaleFormatter *lower, *upper;
            d->getAutomaticFormatters( &lower, &upper );
            const qreal lowerHeight = d->tabHeight( lower->text( startDateTime() ) );
            const qreal upperHeight = d->tabHeight( upper->text( startDateTime() ) );
            const qreal upperRatio = upperHeight/( lowerHeight+upperHeight );

            const QRectF upperHeaderRect( headerRect.x(), headerRect.top(), headerRect.width()-1, headerRect.height() * upperRatio );
            const QRectF lowerHeaderRect( headerRect.x(), upperHeaderRect.bottom()+1, headerRect.width()-1,  headerRect.height()-upperHeaderRect.height()-1 );

            paintUserDefinedHeader( painter, lowerHeaderRect, exposedRect, offset, lower, widget );
            paintUserDefinedHeader( painter, upperHeaderRect, exposedRect, offset, upper, widget );
            break;
        }
    case ScaleUserDefined:
        {
            const qreal lowerHeight = d->tabHeight( d->lower->text( startDateTime() ) );
            const qreal upperHeight = d->tabHeight( d->upper->text( startDateTime() ) );
            const qreal upperRatio = upperHeight/( lowerHeight+upperHeight );

            const QRectF upperHeaderRect( headerRect.x(), headerRect.top(), headerRect.width()-1, headerRect.height() * upperRatio );
            const QRectF lowerHeaderRect( headerRect.x(), upperHeaderRect.bottom()+1, headerRect.width()-1,  headerRect.height()-upperHeaderRect.height()-1 );

            paintUserDefinedHeader( painter, lowerHeaderRect, exposedRect, offset, d->lower, widget );
            paintUserDefinedHeader( painter, upperHeaderRect, exposedRect, offset, d->upper, widget );
        }
        break;
    }
    painter->restore();
}

void DateTimeGrid::paintHourScaleHeader	(	QPainter *	painter,
		const QRectF &	headerRect,
		const QRectF &	exposedRect,
		qreal	offset,
		QWidget *	widget = 0
	)			[protected, virtual]

Paints the hour scale header.

See also:

paintHeader()

Definition at line 939 of file kdganttdatetimegrid.cpp.

References d, dayWidth(), and StockDiagram::Private::Private().

Referenced by paintHeader().

{
    class HourFormatter : public Private::DateTextFormatter {
    public:
        QString format( const QDateTime& dt ) {
            return dt.time().toString( QString::fromAscii( "hh" ) );
        }
        QRect textRect( qreal x, qreal offset, qreal dayWidth, const QRectF& headerRect, const QDateTime& dt ) {
            return QRectF( QPointF( x, headerRect.top() ) + QPointF( -offset + 1.0, headerRect.height() / 2.0 ),
                           QSizeF( dayWidth / 24.0, headerRect.height() / 2.0 ) ).toAlignedRect();
        }
    };
    d->paintHeader( painter, headerRect, exposedRect, offset, widget, // General parameters
                    Private::HeaderHour, new HourFormatter ); // Custom parameters

    class DayFormatter : public Private::DateTextFormatter {
    public:
        QString format( const QDateTime& dt ) {
            return dt.date().toString();
        }
        QRect textRect( qreal x, qreal offset, qreal dayWidth, const QRectF& headerRect, const QDateTime& dt ) {
            return QRectF( QPointF( x, headerRect.top() ) + QPointF( -offset, 0.0 ),
                           QSizeF( dayWidth, headerRect.height() / 2.0 ) ).toRect();
        }
    };
    d->paintHeader( painter, headerRect, exposedRect, offset, widget, // General parameters
                    Private::HeaderDay, new DayFormatter ); // Custom parameters
}

void DateTimeGrid::paintMonthScaleHeader	(	QPainter *	painter,
		const QRectF &	headerRect,
		const QRectF &	exposedRect,
		qreal	offset,
		QWidget *	widget = 0
	)			[protected, virtual]

Paints the week scale header.

See also:

paintHeader()

Definition at line 1039 of file kdganttdatetimegrid.cpp.

References d, dayWidth(), and StockDiagram::Private::Private().

Referenced by paintHeader().

{
    class MonthFormatter : public Private::DateTextFormatter {
    public:
        QString format( const QDateTime& dt ) {
            return QDate::shortMonthName( dt.date().month() );
        }
        QRect textRect( qreal x, qreal offset, qreal dayWidth, const QRectF& headerRect, const QDateTime& dt ) {
            return QRectF( QPointF( x, headerRect.top() ) + QPointF( -offset, headerRect.height() / 2.0 ),
                           QSizeF( dayWidth * dt.date().daysInMonth(), headerRect.height() / 2.0 ) ).toRect();
        }
    };
    d->paintHeader( painter, headerRect, exposedRect, offset, widget, // General parameters
                    Private::HeaderMonth, new MonthFormatter ); // Custom parameters

    class YearFormatter : public Private::DateTextFormatter {
    public:
        QString format( const QDateTime& dt ) {
            return QString::number( dt.date().year() );
        }
        QRect textRect( qreal x, qreal offset, qreal dayWidth, const QRectF& headerRect, const QDateTime& dt ) {
            return QRectF( QPointF( x, headerRect.top() ) + QPointF( -offset, 0.0 ),
                           QSizeF( dayWidth * dt.date().daysInYear(), headerRect.height() / 2.0 ) ).toRect();
        }
    };
    d->paintHeader( painter, headerRect, exposedRect, offset, widget, // General parameters
                    Private::HeaderYear, new YearFormatter ); // Custom parameters
}

void DateTimeGrid::paintUserDefinedHeader	(	QPainter *	painter,
		const QRectF &	headerRect,
		const QRectF &	exposedRect,
		qreal	offset,
		const DateTimeScaleFormatter *	formatter,
		QWidget *	widget = 0
	)			[protected, virtual]

Definition at line 856 of file kdganttdatetimegrid.cpp.

References KDGantt::DateTimeScaleFormatter::alignment(), KDGantt::DateTimeScaleFormatter::currentRangeBegin(), d, KDGantt::DateTimeScaleFormatter::nextRangeBegin(), and KDGantt::DateTimeScaleFormatter::text().

Referenced by paintHeader().

{
    const QStyle* const style = widget ? widget->style() : QApplication::style();

    QDateTime dt = formatter->currentRangeBegin( d->chartXtoDateTime( offset + exposedRect.left() ) ).toUTC();
    qreal x = d->dateTimeToChartX( dt );

    while( x < exposedRect.right() + offset )
    {
        const QDateTime next = formatter->nextRangeBegin( dt );
        const qreal nextx = d->dateTimeToChartX( next );

        QStyleOptionHeader opt;
        if ( widget ) opt.init( widget );
        opt.rect = QRectF( x - offset+1, headerRect.top(), qMax( 1., nextx-x-1 ), headerRect.height() ).toAlignedRect();
        opt.textAlignment = formatter->alignment();
        opt.text = formatter->text( dt );
        style->drawControl( QStyle::CE_Header, &opt, painter, widget );

        dt = next;
        x = nextx;
    }
}

void DateTimeGrid::paintWeekScaleHeader	(	QPainter *	painter,
		const QRectF &	headerRect,
		const QRectF &	exposedRect,
		qreal	offset,
		QWidget *	widget = 0
	)			[protected, virtual]

Paints the week scale header.

See also:

paintHeader()

Definition at line 1006 of file kdganttdatetimegrid.cpp.

References d, dayWidth(), and StockDiagram::Private::Private().

Referenced by paintHeader().

{
    class WeekFormatter : public Private::DateTextFormatter {
    public:
        QString format( const QDateTime& dt ) {
            return QString::number( dt.date().weekNumber() );
        }
        QRect textRect( qreal x, qreal offset, qreal dayWidth, const QRectF& headerRect, const QDateTime& dt ) {
            return QRectF( QPointF( x, headerRect.top() ) + QPointF( -offset, headerRect.height() / 2.0 ),
                           QSizeF( dayWidth * 7, headerRect.height() / 2.0 ) ).toRect();
        }
    };
    d->paintHeader( painter, headerRect, exposedRect, offset, widget, // General parameters
                    Private::HeaderWeek, new WeekFormatter ); // Custom parameters

    class MonthFormatter : public Private::DateTextFormatter {
    public:
        QString format( const QDateTime& dt ) {
            return QDate::longMonthName( dt.date().month() );
        }
        QRect textRect( qreal x, qreal offset, qreal dayWidth, const QRectF& headerRect, const QDateTime& dt ) {
            return QRectF( QPointF( x, headerRect.top() ) + QPointF( -offset, 0.0 ),
                           QSizeF( dayWidth * dt.date().daysInMonth(), headerRect.height() / 2.0 ) ).toRect();
        }
    };
    d->paintHeader( painter, headerRect, exposedRect, offset, widget, // General parameters
                    Private::HeaderMonth, new MonthFormatter ); // Custom parameters
}

QModelIndex AbstractGrid::rootIndex

(

)

const [inherited]

Returns:

the current root index for this grid

Definition at line 78 of file kdganttabstractgrid.cpp.

References d.

{
    return d->root;
}

bool DateTimeGrid::rowSeparators

(

)

const

Returns:

true if row separators are used.

Definition at line 449 of file kdganttdatetimegrid.cpp.

References d.

{
    return d->rowSeparators;
}

DateTimeGrid::Scale DateTimeGrid::scale

(

)

const

Returns:

The scale used to paint the grid.

The default is ScaleAuto, which means the day scale will be used as long as the day width is less or equal to 500.

See also:

Scale

Definition at line 366 of file kdganttdatetimegrid.cpp.

References d.

Referenced by paintGrid(), and paintHeader().

{
    return d->scale;
}

void DateTimeGrid::setDayWidth

(

qreal

w

)

Parameters:

w

The width in pixels for each day in the grid.

The signal gridChanged() is emitted after the day width is changed.

Definition at line 342 of file kdganttdatetimegrid.cpp.

References d, and KDGantt::AbstractGrid::gridChanged().

{
    assert( w>0 );
    d->dayWidth = w;
    emit gridChanged();
}

void DateTimeGrid::setFreeDays

(

const QSet< Qt::DayOfWeek > &

fd

)

Parameters:

fd

A set of days to mark as free in the grid.

Free days are filled with the alternate base brush of the palette used by the view. The signal gridChanged() is emitted after the free days are changed.

Definition at line 436 of file kdganttdatetimegrid.cpp.

References d, and KDGantt::AbstractGrid::gridChanged().

{
    d->freeDays = fd;
    emit gridChanged();
}

void AbstractGrid::setModel

(

QAbstractItemModel *

model

)

[virtual, slot, inherited]

Sets the QAbstractItemModel used by this grid implementation. This is called by the view, you should never need to call this from client code.

Definition at line 58 of file kdganttabstractgrid.cpp.

References d.

Referenced by KDAB_SCOPED_UNITTEST_SIMPLE().

{
    d->model = model;
}

void DateTimeGrid::setNoInformationBrush

(

const QBrush &

brush

)

Sets the brush used to display rows where no data is found. Default is a red pattern. If set to QBrush() rows with no information will not be marked.

Definition at line 463 of file kdganttdatetimegrid.cpp.

References d, and KDGantt::AbstractGrid::gridChanged().

{
    d->noInformationBrush = brush;
    emit gridChanged();
}

void AbstractGrid::setRootIndex

(

const QModelIndex &

idx

)

[virtual, slot, inherited]

Sets the root index used by this grid implementation. This is called by the view, you should never need to call this from client code.

Definition at line 72 of file kdganttabstractgrid.cpp.

References d.

{
    d->root = idx;
}

void DateTimeGrid::setRowSeparators

(

bool

enable

)

Parameters:

enable

Whether to use row separators or not.

Definition at line 454 of file kdganttdatetimegrid.cpp.

References d.

{
    d->rowSeparators = enable;
}

void DateTimeGrid::setScale

(

Scale

s

)

Parameters:

s

The scale to be used to paint the grid.

The signal gridChanged() is emitted after the scale has changed.

See also:

Scale

Definition at line 354 of file kdganttdatetimegrid.cpp.

References d, and KDGantt::AbstractGrid::gridChanged().

{
    d->scale = s;
    emit gridChanged();
}

void DateTimeGrid::setStartDateTime

(

const QDateTime &

dt

)

Parameters:

dt

The start date of the grid. It is used as the beginning of the horizontal scrollbar in the view.

Emits gridChanged() after the start date has changed.

Definition at line 309 of file kdganttdatetimegrid.cpp.

References d, and KDGantt::AbstractGrid::gridChanged().

Referenced by KDAB_SCOPED_UNITTEST_SIMPLE().

{
    d->startDateTime = dt;
    emit gridChanged();
}

void DateTimeGrid::setUserDefinedLowerScale

(

DateTimeScaleFormatter *

lower

)

Sets the scale formatter for the lower part of the header to the user defined formatter to lower. The DateTimeGrid object takes ownership of the formatter, which has to be allocated with new.

You have to set the scale to ScaleUserDefined for this setting to take effect.

See also:

DateTimeScaleFormatter

Definition at line 378 of file kdganttdatetimegrid.cpp.

References d, and KDGantt::AbstractGrid::gridChanged().

{
    delete d->lower;
    d->lower = lower;
    emit gridChanged();
}

void DateTimeGrid::setUserDefinedUpperScale

(

DateTimeScaleFormatter *

upper

)

Sets the scale formatter for the upper part of the header to the user defined formatter to upper. The DateTimeGrid object takes ownership of the formatter, which has to be allocated with new.

You have to set the scale to ScaleUserDefined for this setting to take effect.

See also:

DateTimeScaleFormatter

Definition at line 392 of file kdganttdatetimegrid.cpp.

References d, and KDGantt::AbstractGrid::gridChanged().

{
    delete d->upper;
    d->upper = upper;
    emit gridChanged();
}

void DateTimeGrid::setWeekStart

(

Qt::DayOfWeek

ws

)

Parameters:

ws

The start day of the week.

A solid line is drawn on the grid to mark the beginning of a new week. Emits gridChanged() after the start day has changed.

Definition at line 418 of file kdganttdatetimegrid.cpp.

References d, and KDGantt::AbstractGrid::gridChanged().

{
    d->weekStart = ws;
    emit gridChanged();
}

QDateTime DateTimeGrid::startDateTime

(

)

const

Returns:

The QDateTime used as start date for the grid.

The default is three days before the current date.

Definition at line 299 of file kdganttdatetimegrid.cpp.

References d.

Referenced by KDAB_SCOPED_UNITTEST_SIMPLE(), and paintHeader().

{
    return d->startDateTime;
}

DateTimeScaleFormatter * DateTimeGrid::userDefinedLowerScale

(

)

const

Returns:

The DateTimeScaleFormatter being used to render the lower scale.

Definition at line 401 of file kdganttdatetimegrid.cpp.

References d.

{
    return d->lower;
}

DateTimeScaleFormatter * DateTimeGrid::userDefinedUpperScale

(

)

const

Returns:

The DateTimeScaleFormatter being used to render the upper scale.

Definition at line 408 of file kdganttdatetimegrid.cpp.

References d.

{
    return d->upper;
}

Qt::DayOfWeek DateTimeGrid::weekStart

(

)

const

Returns:

The start day of the week

Definition at line 425 of file kdganttdatetimegrid.cpp.

References d.

{
    return d->weekStart;
}

---

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

• kdganttdatetimegrid.h
• kdganttdatetimegrid.cpp

---