TaskView Class Reference

Container and interface for the tasks. More...

#include <taskview.h>

Inheritance diagram for TaskView:

Public Slots
void	clearActiveTasks ()
QString	clipTotals (const ReportCriteria &rc)
void	deleteTask (Task *task=0)
void	deleteTaskBatch (Task *task=0)
void	deletingTask (Task *deletedTask)
void	editTask ()
void	exportcsvFile ()
QString	exportcsvHistory ()
void	extractTime (int minutes)
void	importPlanner (const QString &fileName="")
void	markTaskAsComplete ()
void	markTaskAsIncomplete ()
void	newSubTask ()
void	newTask (const QString &caption, Task *parent)
void	newTask ()
void	reconfigure ()
void	refresh ()
QString	reFreshTimes ()
QString	report (const ReportCriteria &rc)
QString	save ()
QString	setClipBoardText (const QString &s)
void	setPerCentComplete (int completion)
void	startCurrentTimer ()
void	startTimerFor (Task *task, const QDateTime &startTime=QDateTime::currentDateTime())
void	stopAllTimers (const QDateTime &when=QDateTime::currentDateTime())
void	stopCurrentTimer ()
void	stopTimerFor (Task *task)
timetrackerstorage *	storage ()
void	taskTotalTimesChanged (long session, long total)
void	toggleFocusTracking ()
Signals
void	contextMenuRequested (const QPoint &)
void	reSetTimes ()
void	setStatusBarText (QString)
void	tasksChanged (QList< Task * > activeTasks)
void	timersActive ()
void	timersInactive ()
void	totalTimesChanged (long session, long total)
void	updateButtons ()
Public Member Functions
	TaskView (QWidget *parent=0)
virtual	~TaskView ()
QList< Task * >	activeTasks () const
QString	addTask (const QString &taskame, long total=0, long session=0, const DesktopList &desktops=QVector< int >(0, 0), Task *parent=0)
bool	allEventsHaveEndTiMe ()
void	closeStorage ()
long	count ()
Task *	currentItem () const
QList< HistoryEvent >	getHistory (const QDate &from, const QDate &to) const
bool	isFocusTrackingActive () const
Task *	itemAt (int i)
void	load (const QString &filename)
void	resetTimeForAllTasks ()
void	scheduleSave ()
void	startNewSession ()
Task *	task (const QString &uid)
QStringList	tasks ()
Protected Slots
void	iCalFileModified (ResourceCalendar *)
void	itemStateChanged (QTreeWidgetItem *item)
void	minuteUpdate ()
void	newFocusWindowDetected (const QString &)
void	slotColumnToggled (int)
void	slotCustomContextMenuRequested (const QPoint &)
void	slotItemDoubleClicked (QTreeWidgetItem *item, int)
void	slotSetPercentage (QAction *)
void	slotSetPriority (QAction *)
Protected Member Functions
void	mouseMoveEvent (QMouseEvent *)
void	mousePressEvent (QMouseEvent *)

Detailed Description

Container and interface for the tasks.

Definition at line 53 of file taskview.h.

Constructor & Destructor Documentation

TaskView::TaskView ( QWidget * parent = 0 ) [explicit]

Definition at line 163 of file taskview.cpp.

TaskView::~TaskView ( ) [virtual]

Definition at line 392 of file taskview.cpp.

Member Function Documentation

QList< Task * > TaskView::activeTasks ( ) const

Returns a list of the current active tasks.

Definition at line 1162 of file taskview.cpp.

QString TaskView::addTask	(	const QString &	taskame,
		long	total = `0`,
		long	session = `0`,
		const DesktopList &	desktops = `QVector<int>(0,0)`,
		Task *	parent = `0`
	)

Add a task to view and storage.

Definition at line 859 of file taskview.cpp.

bool TaskView::allEventsHaveEndTiMe ( )

Deliver if all events from the storage have and end time.

Definition at line 505 of file taskview.cpp.

void TaskView::clearActiveTasks ( ) [slot]

clears all active tasks.

Needed e.g. if iCal file was modified by another program and taskview is cleared without stopping tasks IF YOU DO NOT KNOW WHAT YOU ARE DOING, CALL stopAllTimers INSTEAD

Definition at line 712 of file taskview.cpp.

QString TaskView::clipTotals ( const ReportCriteria & rc ) [slot]

Copy totals for current and all sub tasks to clipboard.

Definition at line 1055 of file taskview.cpp.

void TaskView::closeStorage ( )

Close the storage and release lock.

Definition at line 503 of file taskview.cpp.

void TaskView::contextMenuRequested ( const QPoint & ) [signal]

long TaskView::count ( )

Return the total number of items in the view.

Definition at line 642 of file taskview.cpp.

Task * TaskView::currentItem ( ) const

Return the current item in the view, cast to a Task pointer.

Definition at line 399 of file taskview.cpp.

void TaskView::deleteTask ( Task * task = 0 ) [slot]

Deletes the given or the current task (and children) from the view.

Depending on configuration, there may be a user dialog.

Parameters:

task

Task to be deleted. If empty, the current task is deleted. if non-existent, an error message is displayed.

Definition at line 978 of file taskview.cpp.

void TaskView::deleteTaskBatch ( Task * task = 0 ) [slot]

Deletes the given or the current task (and children) from the view.

It does this in batch mode, no user dialog.

Parameters:

task

Task to be deleted. If empty, the current task is deleted. if non-existent, an error message is displayed.

Definition at line 960 of file taskview.cpp.

void TaskView::deletingTask ( Task * deletedTask ) [slot]

receiving signal that a task is being deleted

Definition at line 1033 of file taskview.cpp.

void TaskView::editTask ( ) [slot]

Calls editTask dialog for the current task.

Definition at line 896 of file taskview.cpp.

void TaskView::exportcsvFile ( ) [slot]

Export comma separated values format for task time totals.

Definition at line 611 of file taskview.cpp.

QString TaskView::exportcsvHistory ( ) [slot]

Export comma-separated values format for task history.

Definition at line 626 of file taskview.cpp.

void TaskView::extractTime ( int minutes ) [slot]

Subtracts time from all active tasks, and does not log event.

Definition at line 1028 of file taskview.cpp.

QList< HistoryEvent > TaskView::getHistory	(	const QDate &	from,
		const QDate &	to
	)			const

Return list of start/stop events for given date range.

Definition at line 1044 of file taskview.cpp.

void TaskView::iCalFileModified ( ResourceCalendar * rc ) [protected, slot]

React on another process having modified the iCal file we rely on.

This is not iCalFileChanged.

Definition at line 510 of file taskview.cpp.

void TaskView::importPlanner ( const QString & fileName = "" ) [slot]

used to import tasks from imendio planner

Definition at line 591 of file taskview.cpp.

bool TaskView::isFocusTrackingActive ( ) const

Returns whether the focus tracking is currently active.

Definition at line 1157 of file taskview.cpp.

Task * TaskView::itemAt ( int i )

Return the i'th item (zero-based), cast to a Task pointer.

Definition at line 405 of file taskview.cpp.

void TaskView::itemStateChanged ( QTreeWidgetItem * item ) [protected, slot]

item state stores if a task is expanded so you can see the subtasks

Definition at line 494 of file taskview.cpp.

void TaskView::load ( const QString & filename )

Load the view from storage.

Definition at line 422 of file taskview.cpp.

void TaskView::markTaskAsComplete ( ) [slot]

Definition at line 1015 of file taskview.cpp.

void TaskView::markTaskAsIncomplete ( ) [slot]

Definition at line 1050 of file taskview.cpp.

void TaskView::minuteUpdate ( ) [protected, slot]

Definition at line 812 of file taskview.cpp.

void TaskView::mouseMoveEvent ( QMouseEvent * event ) [protected]

Definition at line 316 of file taskview.cpp.

void TaskView::mousePressEvent ( QMouseEvent * event ) [protected]

Definition at line 351 of file taskview.cpp.

void TaskView::newFocusWindowDetected ( const QString & taskName ) [protected, slot]

React on the focus having changed to Window QString.

Definition at line 275 of file taskview.cpp.

void TaskView::newSubTask ( ) [slot]

Calls newTask dialog with caption "New Sub Task".

Definition at line 886 of file taskview.cpp.

void TaskView::newTask	(	const QString &	caption,
		Task *	parent
	)			`[slot]`

Display edit task dialog and create a new task with results.

Parameters:

caption

Window title of the edit task dialog

Definition at line 828 of file taskview.cpp.

void TaskView::newTask ( ) [slot]

Calls newTask dialog with caption "New Task".

Definition at line 823 of file taskview.cpp.

void TaskView::reconfigure ( ) [slot]

Reconfigures taskView depending on current configuration.

Definition at line 1167 of file taskview.cpp.

void TaskView::refresh ( ) [slot]

Used to refresh (e.g.

after import)

Definition at line 519 of file taskview.cpp.

QString TaskView::reFreshTimes ( ) [slot]

Refresh the times of the tasks, e.g.

when the history has been changed by the user

Definition at line 541 of file taskview.cpp.

QString TaskView::report ( const ReportCriteria & rc ) [slot]

call export function for csv totals or history

Definition at line 606 of file taskview.cpp.

void TaskView::resetTimeForAllTasks ( )

Reset session and total time to zero for all tasks.

Definition at line 772 of file taskview.cpp.

void TaskView::reSetTimes ( ) [signal]

QString TaskView::save ( ) [slot]

Save to persistent storage.

Definition at line 676 of file taskview.cpp.

void TaskView::scheduleSave ( )

Schedule that we should save very soon.

Definition at line 671 of file taskview.cpp.

QString TaskView::setClipBoardText ( const QString & s ) [slot]

Set the text of the application's clipboard.

Definition at line 1066 of file taskview.cpp.

void TaskView::setPerCentComplete ( int completion ) [slot]

Sets % completed for the current task.

Parameters:

completion

The percentage complete to mark the task as.

Definition at line 941 of file taskview.cpp.

void TaskView::setStatusBarText ( QString ) [signal]

void TaskView::slotColumnToggled ( int column ) [protected, slot]

Definition at line 1093 of file taskview.cpp.

void TaskView::slotCustomContextMenuRequested ( const QPoint & pos ) [protected, slot]

Definition at line 1119 of file taskview.cpp.

void TaskView::slotItemDoubleClicked	(	QTreeWidgetItem *	item,
		int
	)			`[protected, slot]`

Definition at line 1073 of file taskview.cpp.

void TaskView::slotSetPercentage ( QAction * action ) [protected, slot]

Definition at line 1140 of file taskview.cpp.

void TaskView::slotSetPriority ( QAction * action ) [protected, slot]

Definition at line 1149 of file taskview.cpp.

void TaskView::startCurrentTimer ( ) [slot]

Start the timer on the current item (task) in view.

Definition at line 688 of file taskview.cpp.

void TaskView::startNewSession ( )

Reset session time to zero for all tasks.

Definition at line 756 of file taskview.cpp.

void TaskView::startTimerFor	(	Task *	task,
		const QDateTime &	startTime = `QDateTime::currentDateTime()`
	)			`[slot]`

starts timer for task.

Parameters:

	task	task to start timer of
	startTime	if taskview has been modified by another program, we have to set the starting time to not-now.

Definition at line 693 of file taskview.cpp.

void TaskView::stopAllTimers ( const QDateTime & when = QDateTime::currentDateTime() ) [slot]

Stop all running timers.

Parameters:

when

When the timer stopped - this makes sense if the idletime- detector detects the user stopped working 5 minutes ago.

Definition at line 717 of file taskview.cpp.

void TaskView::stopCurrentTimer ( ) [slot]

Stop the timer for the current item in the view.

Definition at line 803 of file taskview.cpp.

void TaskView::stopTimerFor ( Task * task ) [slot]

Definition at line 786 of file taskview.cpp.

timetrackerstorage * TaskView::storage ( ) [slot]

Returns a pointer to storage object.

This is poor object oriented design--the task view should expose wrappers around the storage methods we want to access instead of giving clients full access to objects that we own.

Hopefully, this will be redesigned as part of the Qt4 migration.

Definition at line 387 of file taskview.cpp.

Task * TaskView::task ( const QString & uid )

return the task with the given UID

Definition at line 661 of file taskview.cpp.

QStringList TaskView::tasks ( )

return all task names, e.g.

for batch processing

Definition at line 649 of file taskview.cpp.

void TaskView::tasksChanged ( QList< Task * > activeTasks ) [signal]

void TaskView::taskTotalTimesChanged	(	long	session,
		long	total
	)			`[inline, slot]`

Definition at line 197 of file taskview.h.

void TaskView::timersActive ( ) [signal]

void TaskView::timersInactive ( ) [signal]

void TaskView::toggleFocusTracking ( ) [slot]

Toggles the automatic tracking of focused windows.

Definition at line 739 of file taskview.cpp.

void TaskView::totalTimesChanged	(	long	session,
		long	total
	)			`[signal]`

void TaskView::updateButtons ( ) [signal]

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

ktimetracker

TaskView Class Reference

Public Slots

Signals

Public Member Functions

Protected Slots

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

ktimetracker

kdepim