KDGantt::Legend Class Reference

#include <KDGanttLegend>

Inheritance diagram for KDGantt::Legend:

[legend]

Collaboration diagram for KDGantt::Legend:

[legend]

List of all members.

---

Detailed Description

Legend showing an image and a description for Gantt items.

This is an item view class showing a small Gantt item and it's text defined by LegendRole.

Definition at line 35 of file kdganttlegend.h.

Public Member Functions
QModelIndex	indexAt (const QPoint &point) const
	Legend (QWidget *parent=0)
QSize	minimumSizeHint () const
void	scrollTo (const QModelIndex &, ScrollHint=EnsureVisible)
void	setModel (QAbstractItemModel *model)
QSize	sizeHint () const
QRect	visualRect (const QModelIndex &index) const
virtual	~Legend ()
Protected Slots
virtual void	modelDataChanged ()
Protected Member Functions
virtual QRect	drawItem (QPainter *painter, const QModelIndex &index, const QPoint &pos=QPoint()) const
virtual StyleOptionGanttItem	getStyleOption (const QModelIndex &index) const
int	horizontalOffset () const
bool	isIndexHidden (const QModelIndex &) const
virtual QSize	measureItem (const QModelIndex &index, bool recursive=true) const
QModelIndex	moveCursor (CursorAction, Qt::KeyboardModifiers)
void	paintEvent (QPaintEvent *event)
void	setSelection (const QRect &, QItemSelectionModel::SelectionFlags)
int	verticalOffset () const
QRegion	visualRegionForSelection (const QItemSelection &) const

---

Constructor & Destructor Documentation

Legend::Legend

(

QWidget *

parent = 0

)

[explicit]

Constructor. Creates a Legend with parent parent. The QObject parent is not used for anything internally.

Definition at line 47 of file kdganttlegend.cpp.

    : QAbstractItemView( parent ),
      _d( new Private )
{
    setItemDelegate( new ItemDelegate( this ) );
    setFrameStyle( QFrame::NoFrame );
}

Legend::~Legend

(

)

[virtual]

Destructor. Does nothing

Definition at line 56 of file kdganttlegend.cpp.

{
    delete _d;
}

---

Member Function Documentation

QRect Legend::drawItem	(	QPainter *	painter,
		const QModelIndex &	index,
		const QPoint &	pos = QPoint()
	)			const [protected, virtual]

Draws the legend item at index and all of it's children recursively at pos onto painter. Reimplement this if you want to draw items in an user defined way.

Returns:

the rectangle drawn.

Definition at line 144 of file kdganttlegend.cpp.

References KDGantt::StyleOptionGanttItem::boundingRect, d, getStyleOption(), KDGantt::StyleOptionGanttItem::itemRect, KDGantt::ItemTypeRole, measureItem(), KDGantt::ItemDelegate::paintGanttItem(), r, KDGantt::StyleOptionGanttItem::text, and KDGantt::TypeEvent.

Referenced by paintEvent().

{
    int xPos = pos.x();
    int yPos = pos.y();

    if( index.isValid() && index.model() == &d->proxyModel )
    {
        ItemDelegate* const delegate = qobject_cast< ItemDelegate* >( itemDelegate( index ) );
        assert( delegate != 0 );
        const QRect r( pos, measureItem( index, false ) );
        StyleOptionGanttItem opt = getStyleOption( index );
        opt.rect = r;
        opt.rect.setWidth( r.height() );

        const ItemType typ = static_cast<ItemType>( index.model()->data( index, ItemTypeRole ).toInt() );
        const int dx = (typ == TypeEvent) ? (r.height() / 2) : 0;

        opt.itemRect = opt.rect.adjusted(dx,0,dx,0);
        opt.boundingRect = r;
        opt.boundingRect.setWidth( r.width() + r.height() );
        if( !opt.text.isNull() )
            delegate->paintGanttItem( painter, opt, index );

        xPos = r.right();
        yPos = r.bottom();
    }

    
    const int rowCount = d->proxyModel.rowCount( index );
    for( int row = 0; row < rowCount; ++row )
    {
        const QRect r = drawItem( painter, d->proxyModel.index( row, 0, index ), QPoint( pos.x(), yPos ) );
        xPos = qMax( xPos, r.right() );
        yPos = qMax( yPos, r.bottom() );
    }

    return QRect( pos, QPoint( xPos, yPos ) );
}

StyleOptionGanttItem Legend::getStyleOption

(

const QModelIndex &

index

)

const [protected, virtual]

Creates a StyleOptionGanttItem with all style options filled in except the target rectangles.

Definition at line 129 of file kdganttlegend.cpp.

References d, KDGantt::StyleOptionGanttItem::displayPosition, KDGantt::LegendRole, KDGantt::StyleOptionGanttItem::Right, and KDGantt::StyleOptionGanttItem::text.

Referenced by drawItem().

{
    StyleOptionGanttItem opt;
    opt.displayPosition = StyleOptionGanttItem::Right;
    opt.displayAlignment = Qt::Alignment( d->proxyModel.data( index, Qt::TextAlignmentRole ).toInt() );
    opt.text = index.model()->data( index, LegendRole ).toString();
    opt.font = qVariantValue< QFont >( index.model()->data( index, Qt::FontRole ) );
    return opt;
}

int KDGantt::Legend::horizontalOffset

(

)

const [protected]

Definition at line 60 of file kdganttlegend.h.

{ return 0; }

QModelIndex Legend::indexAt

(

const QPoint &

point

)

const

Definition at line 63 of file kdganttlegend.cpp.

{
    Q_UNUSED( point );
    return QModelIndex();
}

bool KDGantt::Legend::isIndexHidden

(

const QModelIndex &

)

const [protected]

Definition at line 61 of file kdganttlegend.h.

{ return false; }

QSize Legend::measureItem	(	const QModelIndex &	index,
		bool	recursive = true
	)			const [protected, virtual]

Calculates the needed space for the legend item at index and, if recursive is true, all child items.

Definition at line 186 of file kdganttlegend.cpp.

References d, and KDGantt::LegendRole.

Referenced by drawItem(), minimumSizeHint(), and sizeHint().

{
    if( model() == 0 )
        return QSize();

    QSize baseSize;
    if( index.model() != 0 )
    {
        QFontMetrics fm( qVariantValue< QFont >( index.model()->data( index, Qt::FontRole ) ) );
        const QString text = index.model()->data( index, LegendRole ).toString();
        if( !text.isEmpty() )
            baseSize += QSize( fm.width( text ) + fm.height() + 2, fm.height() + 2 );
    }

    if( !recursive )
        return baseSize;

    QSize childrenSize;

    const int rowCount = d->proxyModel.rowCount( index );
    for( int row = 0; row < rowCount; ++row )
    {
        const QSize childSize = measureItem( d->proxyModel.index( row, 0, index ) );
        childrenSize.setWidth( qMax( childrenSize.width(), childSize.width() ) );
        childrenSize.rheight() += childSize.height();
    }
    return baseSize + childrenSize;
}

QSize Legend::minimumSizeHint

(

)

const

Definition at line 80 of file kdganttlegend.cpp.

References measureItem().

{
    return measureItem( rootIndex() );
}

void Legend::modelDataChanged

(

)

[protected, virtual, slot]

Triggers repainting of the legend.

Definition at line 108 of file kdganttlegend.cpp.

Referenced by setModel().

{
    updateGeometry();
    viewport()->update();
}

QModelIndex KDGantt::Legend::moveCursor	(	CursorAction	,
		Qt::KeyboardModifiers
	)			[protected]

Definition at line 62 of file kdganttlegend.h.

{ return QModelIndex(); }

void Legend::paintEvent

(

QPaintEvent *

event

)

[protected]

Definition at line 114 of file kdganttlegend.cpp.

References drawItem(), and p.

{
    Q_UNUSED( event );
    // no model, no legend...
    if( model() == 0 )
        return;

    QPainter p( viewport() );
    p.fillRect( viewport()->rect(), palette().color( QPalette::Window ) );
    drawItem( &p, rootIndex() );
}

void KDGantt::Legend::scrollTo	(	const QModelIndex &	,
		ScrollHint	= EnsureVisible
	)

Definition at line 46 of file kdganttlegend.h.

{}

void Legend::setModel

(

QAbstractItemModel *

model

)

Definition at line 85 of file kdganttlegend.cpp.

References d, and modelDataChanged().

{
    if( this->model() != 0 )
    {
        disconnect( this->model(), SIGNAL( dataChanged( QModelIndex, QModelIndex ) ), this, SLOT( modelDataChanged() ) );
        disconnect( this->model(), SIGNAL( rowsRemoved( QModelIndex, int, int ) ), this, SLOT( modelDataChanged() ) );
        disconnect( this->model(), SIGNAL( columnsRemoved( QModelIndex, int, int ) ), this, SLOT( modelDataChanged() ) );
    }

    QAbstractItemView::setModel( model );
    d->proxyModel.setSourceModel( model );

    if( this->model() != 0 )
    {
        connect( this->model(), SIGNAL( dataChanged( QModelIndex, QModelIndex ) ), this, SLOT( modelDataChanged() ) );
        connect( this->model(), SIGNAL( rowsRemoved( QModelIndex, int, int ) ), this, SLOT( modelDataChanged() ) );
        connect( this->model(), SIGNAL( columnsRemoved( QModelIndex, int, int ) ), this, SLOT( modelDataChanged() ) );
    }

}

void KDGantt::Legend::setSelection	(	const QRect &	,
		QItemSelectionModel::SelectionFlags
	)			[protected]

Definition at line 63 of file kdganttlegend.h.

{}

QSize Legend::sizeHint

(

)

const

Definition at line 75 of file kdganttlegend.cpp.

References measureItem().

{
    return measureItem( rootIndex() );
}

int KDGantt::Legend::verticalOffset

(

)

const [protected]

Definition at line 64 of file kdganttlegend.h.

{ return 0; }

QRect Legend::visualRect

(

const QModelIndex &

index

)

const

Definition at line 69 of file kdganttlegend.cpp.

{
    Q_UNUSED( index );
    return QRect();
}

QRegion KDGantt::Legend::visualRegionForSelection

(

const QItemSelection &

)

const [protected]

Definition at line 65 of file kdganttlegend.h.

{ return QRegion(); }

---

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

• kdganttlegend.h
• kdganttlegend.cpp

---