The GraphicsView class provides a model/view implementation of a gantt chart. More...

#include <KDGanttGraphicsView>

Inheritance diagram for KDGantt::GraphicsView:

Collaboration diagram for KDGantt::GraphicsView:

Public Slots
void	setConstraintModel (ConstraintModel *)

void	setGrid (AbstractGrid *)

void	setItemDelegate (ItemDelegate *delegate)

void	setModel (QAbstractItemModel *)

void	setReadOnly (bool)

void	setRootIndex (const QModelIndex &)

void	setRowController (AbstractRowController *)

void	setSelectionModel (QItemSelectionModel *)

void	setSummaryHandlingModel (QAbstractProxyModel *model)

void	updateSceneRect ()

Signals
void	activated (const QModelIndex &index)

void	clicked (const QModelIndex &index)

void	entered (const QModelIndex &index)

void	headerContextMenuRequested (const QPoint &pt)

void	pressed (const QModelIndex &index)

void	qrealClicked (const QModelIndex &index)

Public Member Functions
virtual void	addConstraint (const QModelIndex &from, const QModelIndex &to, Qt::KeyboardModifiers modifiers)

void	clearItems ()

ConstraintModel *	constraintModel () const

void	deleteSubtree (const QModelIndex &)

	GraphicsView (QWidget *parent=0)

AbstractGrid *	grid () const

Qt::ContextMenuPolicy	headerContextMenuPolicy () const

QModelIndex	indexAt (const QPoint &pos) const

bool	isReadOnly () const

ItemDelegate *	itemDelegate () const

QAbstractItemModel *	model () const

void	print (QPrinter *printer, bool drawRowLabels=true, bool drawColumnLabels=true)

void	print (QPrinter *printer, qreal start, qreal end, bool drawRowLabels=true, bool drawColumnLabels=true)

void	print (QPainter *painter, const QRectF &target=QRectF(), bool drawRowLabels=true, bool drawColumnLabels=true)

void	print (QPainter *painter, qreal start, qreal end, const QRectF &target=QRectF(), bool drawRowLabels=true, bool drawColumnLabels=true)

QModelIndex	rootIndex () const

AbstractRowController *	rowController () const

QItemSelectionModel *	selectionModel () const

void	setHeaderContextMenuPolicy (Qt::ContextMenuPolicy)

QAbstractProxyModel *	summaryHandlingModel () const

void	updateRow (const QModelIndex &)

void	updateScene ()

	~GraphicsView () override

Protected Member Functions
void	resizeEvent (QResizeEvent *) override

Properties
bool	readOnly

Detailed Description

The GraphicsView class provides a model/view implementation of a gantt chart.

Definition at line 45 of file kdganttgraphicsview.h.

Constructor & Destructor Documentation

GraphicsView::GraphicsView ( QWidget * parent = 0 )

explicit

Constructor. Creates a new KDGantt::GraphicsView with parent parent.

Definition at line 338 of file kdganttgraphicsview.cpp.

References clicked(), entered(), pressed(), qrealClicked(), setSummaryHandlingModel(), and updateSceneRect().

GraphicsView::~GraphicsView ( )

override

Destroys this view.

Definition at line 374 of file kdganttgraphicsview.cpp.

Member Function Documentation

void KDGantt::GraphicsView::activated ( const QModelIndex & index )

signal

void GraphicsView::addConstraint	(	const QModelIndex &	from,
		const QModelIndex &	to,
		Qt::KeyboardModifiers	modifiers
	)

virtual

Adds a constraint from from to to. modifiers are the keyboard modifiers pressed by the user when the action is invoked.

Override this to control how contraints are added. The default implementation adds a soft constraint unless the Shift key is pressed, in that case it adds a hard constraint. If a constraint is already present, it is removed and nothing is added.

Definition at line 590 of file kdganttgraphicsview.cpp.

References KDGantt::ConstraintModel::addConstraint(), constraintModel(), KDGantt::ConstraintModel::hasConstraint(), isReadOnly(), KDGantt::ConstraintModel::removeConstraint(), KDGantt::Constraint::TypeHard, and KDGantt::Constraint::TypeSoft.

Referenced by KDGantt::GraphicsItem::mouseReleaseEvent().

void GraphicsView::clearItems ( )

Definition at line 645 of file kdganttgraphicsview.cpp.

References d.

Referenced by updateScene().

void KDGantt::GraphicsView::clicked ( const QModelIndex & index )

signal

Referenced by GraphicsView().

ConstraintModel * GraphicsView::constraintModel ( ) const

Returns: the KDGantt::ConstraintModel displayed by this view.

Definition at line 451 of file kdganttgraphicsview.cpp.

References d.

Referenced by addConstraint().

void GraphicsView::deleteSubtree ( const QModelIndex & idx )

Definition at line 711 of file kdganttgraphicsview.cpp.

References d.

void KDGantt::GraphicsView::entered ( const QModelIndex & index )

signal

Referenced by GraphicsView().

AbstractGrid * GraphicsView::grid ( ) const

Returns: the AbstractGrid used by this view.

Definition at line 541 of file kdganttgraphicsview.cpp.

References d.

Referenced by KDGantt::View::setGraphicsView().

Qt::ContextMenuPolicy GraphicsView::headerContextMenuPolicy ( ) const

Returns: the context menu policy for the header

Definition at line 577 of file kdganttgraphicsview.cpp.

References d.

void GraphicsView::headerContextMenuRequested ( const QPoint & pt )

signal

This signal is emitted when the header has contextMenuPolicy Qt::CustomContextMenu and the widget wants to show a context menu for the header. Unlike in QWidget::customContextMenuRequested() signal, pt is here in global coordinates.

QModelIndex GraphicsView::indexAt ( const QPoint & pos ) const

Returns: The QModelIndex for the item located at position pos in the view or an invalid index if no item was present at that position.

This is useful for example contextmenus.

Definition at line 634 of file kdganttgraphicsview.cpp.

References d.

bool GraphicsView::isReadOnly ( ) const

Returns: true iff the view is in read-only mode

Definition at line 556 of file kdganttgraphicsview.cpp.

References d.

Referenced by addConstraint().

ItemDelegate * GraphicsView::itemDelegate ( ) const

Returns: the ItemDelegate used by this view to render items

Definition at line 503 of file kdganttgraphicsview.cpp.

References d.

QAbstractItemModel * GraphicsView::model ( ) const

Returns: the current model displayed by this view

Definition at line 408 of file kdganttgraphicsview.cpp.

References d.

Referenced by updateScene().

void KDGantt::GraphicsView::pressed ( const QModelIndex & index )

signal

Referenced by GraphicsView().

void GraphicsView::print	(	QPrinter *	printer,
		bool	drawRowLabels = `true`,
		bool	drawColumnLabels = `true`
	)

Print the Gantt chart using printer. If drawRowLabels is true (the default), each row will have it's label printed on the left side. If drawColumnLabels is true (the default), each column will have it's label printed at the top side.

This version of print() will print multiple pages.

Definition at line 724 of file kdganttgraphicsview.cpp.

References d.

Referenced by KDGantt::View::print().

void GraphicsView::print	(	QPrinter *	printer,
		qreal	start,
		qreal	end,
		bool	drawRowLabels = `true`,
		bool	drawColumnLabels = `true`
	)

Print part of the Gantt chart from start to end using printer. If drawRowLabels is true (the default), each row will have it's label printed on the left side. If drawColumnLabels is true (the default), each column will have it's label printed at the top side.

This version of print() will print multiple pages.

To print a certain range of a chart with a DateTimeGrid, use qreal DateTimeGrid::mapFromDateTime( const QDateTime& dt) const to figure out the values for start and end.

Definition at line 741 of file kdganttgraphicsview.cpp.

References d.

void GraphicsView::print	(	QPainter *	painter,
		const QRectF &	targetRect = `QRectF()`,
		bool	drawRowLabels = `true`,
		bool	drawColumnLabels = `true`
	)

Render the GanttView inside the rectangle target using the painter painter. If drawRowLabels is true (the default), each row will have it's label printed on the left side. If drawColumnLabels is true (the default), each column will have it's label printed at the top side.

Definition at line 752 of file kdganttgraphicsview.cpp.

References d.

void GraphicsView::print	(	QPainter *	painter,
		qreal	start,
		qreal	end,
		const QRectF &	targetRect = `QRectF()`,
		bool	drawRowLabels = `true`,
		bool	drawColumnLabels = `true`
	)

Render the GanttView inside the rectangle target using the painter painter. If drawRowLabels is true (the default), each row will have it's label printed on the left side. If drawColumnLabels is true (the default), each column will have it's label printed at the top side.

To print a certain range of a chart with a DateTimeGrid, use qreal DateTimeGrid::mapFromDateTime( const QDateTime& dt) const to figure out the values for start and end.

Definition at line 767 of file kdganttgraphicsview.cpp.

References d.

void KDGantt::GraphicsView::qrealClicked ( const QModelIndex & index )

signal

Referenced by GraphicsView().

void GraphicsView::resizeEvent ( QResizeEvent * ev )

overrideprotected

Definition at line 602 of file kdganttgraphicsview.cpp.

References d, rowController(), and KDGantt::AbstractRowController::totalHeight().

QModelIndex GraphicsView::rootIndex ( ) const

Returns: the rootindex for this view.

Definition at line 473 of file kdganttgraphicsview.cpp.

References d.

Referenced by updateScene().

AbstractRowController * GraphicsView::rowController ( ) const

Returns: the AbstractRowController for this view.

See also: setRowController

Definition at line 523 of file kdganttgraphicsview.cpp.

References d.

Referenced by resizeEvent(), updateScene(), and updateSceneRect().

QItemSelectionModel * GraphicsView::selectionModel ( ) const

Returns: the QItemSelectionModel used by this view

Definition at line 488 of file kdganttgraphicsview.cpp.

References d.

void GraphicsView::setConstraintModel ( ConstraintModel * cmodel )

slot

Sets the constraintmodel displayed by this view.

See also: KDGantt::ConstraintModel.

Definition at line 444 of file kdganttgraphicsview.cpp.

References d.

void GraphicsView::setGrid ( AbstractGrid * grid )

slot

Sets the AbstractGrid for this view. The grid is an object that controls how QModelIndexes are mapped to and from the view and how the background and header is rendered.

See also: AbstractGrid and DateTimeGrid.

Definition at line 533 of file kdganttgraphicsview.cpp.

References d.

void GraphicsView::setHeaderContextMenuPolicy ( Qt::ContextMenuPolicy p )

Sets the context menu policy for the header. The default value Qt::DefaultContextMenu results in a standard context menu on the header that allows the user to set the scale and zoom.

Setting this to Qt::CustomContextMenu will cause the signal headerContextMenuRequested(const QPoint& pt) to be emitted instead.

See also: QWidget::setContextMenuPolicy( Qt::ContextMenuPolicy )

Definition at line 570 of file kdganttgraphicsview.cpp.

References d.

void GraphicsView::setItemDelegate ( ItemDelegate * delegate )

slot

Sets the KDGantt::ItemDelegate used for rendering items on this view.

See also: ItemDelegate and QAbstractItemDelegate.

Definition at line 496 of file kdganttgraphicsview.cpp.

References d.

void GraphicsView::setModel ( QAbstractItemModel * model )

slot

Sets the model to be displayed in this view to model. The view does not take ownership of the model.

To make a model work well with GraphicsView it must have a certain layout. Whether the model is flat or has a treestrucure is not important, as long as an AbstractRowController is provided that can navigate the model.

GraphicsView operates per row in the model. The data is always taken from the last item in the row. The ItemRoles used are Qt::DisplayRole and the roles defined in KDGantt::ItemDataRole.

Definition at line 394 of file kdganttgraphicsview.cpp.

References d, updateScene(), and updateSceneRect().

Referenced by KDAB_SCOPED_UNITTEST_SIMPLE().

void GraphicsView::setReadOnly ( bool ro )

slot

Sets the view to read-only mode if to is true. The default is read/write if the model permits it.

Definition at line 549 of file kdganttgraphicsview.cpp.

References d.

void GraphicsView::setRootIndex ( const QModelIndex & idx )

slot

Sets the root index of the model displayed by this view. Similar to QAbstractItemView::setRootIndex, default is QModelIndex().

Definition at line 466 of file kdganttgraphicsview.cpp.

References d.

void GraphicsView::setRowController ( AbstractRowController * rowcontroller )

slot

Sets the AbstractRowController used by this view. The AbstractRowController deals with the height and position of each row and with which parts of the model are displayed.