ktimetracker

TaskView Class Reference

#include <taskview.h>

Inheritance diagram for TaskView:

[legend]

List of all members.

Detailed Description

Container and interface for the tasks.

Definition at line 53 of file taskview.h.


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 *)

Constructor & Destructor Documentation

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

Definition at line 153 of file taskview.cpp.

TaskView::~TaskView ( ) [virtual]

Definition at line 365 of file taskview.cpp.

Member Function Documentation

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

Returns a list of the current active tasks.

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

bool TaskView::allEventsHaveEndTiMe ( )

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

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

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

Copy totals for current and all sub tasks to clipboard.

Definition at line 1020 of file taskview.cpp.

void TaskView::closeStorage ( )

Close the storage and release lock.

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

Task * TaskView::currentItem ( ) const

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

Definition at line 372 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-existant, an error message is displayed.

Definition at line 943 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-existant, an error message is displayed.

Definition at line 925 of file taskview.cpp.

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

receiving signal that a task is being deleted

Definition at line 998 of file taskview.cpp.

void TaskView::editTask ( ) [slot]

Calls editTask dialog for the current task.

Definition at line 860 of file taskview.cpp.

void TaskView::exportcsvFile ( ) [slot]

Export comma separated values format for task time totals.

Definition at line 585 of file taskview.cpp.

QString TaskView::exportcsvHistory ( ) [slot]

Export comma-separated values format for task history.

Definition at line 599 of file taskview.cpp.

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

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

Definition at line 993 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 1009 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 482 of file taskview.cpp.

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

used to import tasks from imendio planner

Definition at line 565 of file taskview.cpp.

bool TaskView::isFocusTrackingActive ( ) const

Returns whether the focus tracking is currently active.

Definition at line 1114 of file taskview.cpp.

Task * TaskView::itemAt ( int i )

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

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

void TaskView::load ( const QString & filename )

Load the view from storage.

Definition at line 395 of file taskview.cpp.

void TaskView::markTaskAsComplete ( ) [slot]

Definition at line 980 of file taskview.cpp.

void TaskView::markTaskAsIncomplete ( ) [slot]

Definition at line 1015 of file taskview.cpp.

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

Definition at line 776 of file taskview.cpp.

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

Definition at line 296 of file taskview.cpp.

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

Definition at line 331 of file taskview.cpp.

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

React on the focus having changed to Window QString.

Definition at line 262 of file taskview.cpp.

void TaskView::newSubTask ( ) [slot]

Calls newTask dialog with caption "New Sub Task".

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

void TaskView::newTask ( ) [slot]

Calls newTask dialog with caption "New Task".

Definition at line 787 of file taskview.cpp.

void TaskView::reconfigure ( ) [slot]

Reconfigures taskView depending on current configuration.

Definition at line 1124 of file taskview.cpp.

void TaskView::refresh ( ) [slot]

Used to refresh (e.g.

after import)

Definition at line 491 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 513 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 907 of file taskview.cpp.

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

call export function for csv totals or history

Definition at line 580 of file taskview.cpp.

void TaskView::resetTimeForAllTasks ( )

Reset session and total time to zero for all tasks.

Definition at line 736 of file taskview.cpp.

void TaskView::reSetTimes ( ) [signal]

QString TaskView::save ( ) [slot]

Save to persistent storage.

Definition at line 648 of file taskview.cpp.

void TaskView::scheduleSave ( )

Schedule that we should save very soon.

Definition at line 643 of file taskview.cpp.

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

Set the text of the application's clipboard.

Definition at line 1031 of file taskview.cpp.

void TaskView::setStatusBarText ( QString ) [signal]

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

Definition at line 1053 of file taskview.cpp.

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

Definition at line 1079 of file taskview.cpp.

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

Definition at line 1038 of file taskview.cpp.

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

Definition at line 1099 of file taskview.cpp.

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

Definition at line 1107 of file taskview.cpp.

void TaskView::startCurrentTimer ( ) [slot]

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

Definition at line 660 of file taskview.cpp.

void TaskView::startNewSession ( )

Reset session time to zero for all tasks.

Definition at line 720 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 665 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 689 of file taskview.cpp.

void TaskView::stopCurrentTimer ( ) [slot]

Stop the timer for the current item in the view.

Definition at line 767 of file taskview.cpp.

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

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

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

return the task with the given UID

Definition at line 633 of file taskview.cpp.

QStringList TaskView::tasks ( )

return all task names, e.g.

for batch processing

Definition at line 621 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 703 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

Detailed Description

Public Slots

Signals

Public Member Functions

Protected Slots

Protected Member Functions

Constructor & Destructor Documentation

Member Function Documentation

ktimetracker

kdepim