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 ()
void	reinstateTask (int completion)
QString	report (const ReportCriteria &rc)
QString	save ()
QString	setClipBoardText (const QString &s)
void	startCurrentTimer ()
void	startTimerFor (Task *task, const QDateTime &startTime=QDateTime::currentDateTime())
void	stopAllTimers (const QDateTime &when=QDateTime::currentDateTime())
void	stopCurrentTimer ()
void	stopTimerFor (Task *task)
KarmStorage *	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
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 ()
	TaskView (QWidget *parent=0)
virtual	~TaskView ()
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 154 of file taskview.cpp.

TaskView::~TaskView ( ) [virtual]

Definition at line 376 of file taskview.cpp.

Member Function Documentation

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

Returns a list of the current active tasks.

Definition at line 1138 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 842 of file taskview.cpp.

bool TaskView::allEventsHaveEndTiMe ( )

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

Definition at line 488 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 695 of file taskview.cpp.

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

Copy totals for current and all sub tasks to clipboard.

Definition at line 1039 of file taskview.cpp.

void TaskView::closeStorage ( )

Close the storage and release lock.

Definition at line 486 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 625 of file taskview.cpp.

Task * TaskView::currentItem ( ) const

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

Definition at line 383 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 962 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 944 of file taskview.cpp.

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

receiving signal that a task is being deleted

Definition at line 1017 of file taskview.cpp.

void TaskView::editTask ( ) [slot]

Calls editTask dialog for the current task.

Definition at line 879 of file taskview.cpp.

void TaskView::exportcsvFile ( ) [slot]

Export comma separated values format for task time totals.

Definition at line 596 of file taskview.cpp.

QString TaskView::exportcsvHistory ( ) [slot]

Export comma-separated values format for task history.

Definition at line 610 of file taskview.cpp.

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

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

Definition at line 1012 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 1028 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 493 of file taskview.cpp.

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

used to import tasks from imendio planner

Definition at line 576 of file taskview.cpp.

bool TaskView::isFocusTrackingActive ( ) const

Returns whether the focus tracking is currently active.

Definition at line 1133 of file taskview.cpp.

Task * TaskView::itemAt ( int i )

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

Definition at line 389 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 477 of file taskview.cpp.

void TaskView::load ( const QString & filename )

Load the view from storage.

Definition at line 406 of file taskview.cpp.

void TaskView::markTaskAsComplete ( ) [slot]

Definition at line 999 of file taskview.cpp.

void TaskView::markTaskAsIncomplete ( ) [slot]

Definition at line 1034 of file taskview.cpp.

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

Definition at line 795 of file taskview.cpp.

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

Definition at line 298 of file taskview.cpp.

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

Definition at line 333 of file taskview.cpp.

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

React on the focus having changed to Window QString.

Definition at line 264 of file taskview.cpp.

void TaskView::newSubTask ( ) [slot]

Calls newTask dialog with caption "New Sub Task".

Definition at line 869 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 811 of file taskview.cpp.

void TaskView::newTask ( ) [slot]

Calls newTask dialog with caption "New Task".

Definition at line 806 of file taskview.cpp.

void TaskView::reconfigure ( ) [slot]

Reconfigures taskView depending on current configuration.

Definition at line 1143 of file taskview.cpp.

void TaskView::refresh ( ) [slot]

Used to refresh (e.g.

after import)

Definition at line 502 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 524 of file taskview.cpp.

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

Reinstates the current task as incomplete.

Parameters:

completion

The percentage complete to mark the task as.

Definition at line 926 of file taskview.cpp.

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

call export function for csv totals or history

Definition at line 591 of file taskview.cpp.

void TaskView::resetTimeForAllTasks ( )

Reset session and total time to zero for all tasks.

Definition at line 755 of file taskview.cpp.

void TaskView::reSetTimes ( ) [signal]

QString TaskView::save ( ) [slot]

Save to persistent storage.

Definition at line 659 of file taskview.cpp.

void TaskView::scheduleSave ( )

Schedule that we should save very soon.

Definition at line 654 of file taskview.cpp.

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

Set the text of the application's clipboard.

Definition at line 1050 of file taskview.cpp.

void TaskView::setStatusBarText ( QString ) [signal]

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

Definition at line 1072 of file taskview.cpp.

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

Definition at line 1098 of file taskview.cpp.

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

Definition at line 1057 of file taskview.cpp.

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

Definition at line 1118 of file taskview.cpp.

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

Definition at line 1126 of file taskview.cpp.

void TaskView::startCurrentTimer ( ) [slot]

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

Definition at line 671 of file taskview.cpp.

void TaskView::startNewSession ( )

Reset session time to zero for all tasks.

Definition at line 739 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 676 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 700 of file taskview.cpp.

void TaskView::stopCurrentTimer ( ) [slot]

Stop the timer for the current item in the view.

Definition at line 786 of file taskview.cpp.

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

Definition at line 769 of file taskview.cpp.

KarmStorage * 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 371 of file taskview.cpp.

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

return the task with the given UID

Definition at line 644 of file taskview.cpp.

QStringList TaskView::tasks ( )

return all task names, e.g.

for batch processing

Definition at line 632 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 722 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