FCL/sf/mw/homescreensrv: tstaskmonitor/client/src/tstaskmonitor.cpp@9b022b1f357c (annotated)

80 397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	1	/*
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	2	* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	3	* All rights reserved.
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	4	* This component and the accompanying materials are made available
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	5	* under the terms of "Eclipse Public License v1.0"
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	6	* which accompanies this distribution, and is available
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	7	* at the URL "http://www.eclipse.org/legal/epl-v10.html".
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	8	*
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	9	* Initial Contributors:
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	10	* Nokia Corporation - initial contribution.
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	11	*
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	12	* Contributors:
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	13	*
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	14	* Description:
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	15	*
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	16	*/
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	17
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	18	#include "tstaskmonitor.h"
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	19	#include "tstaskmonitor_p.h"
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	20
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	21	#include "tstask.h"
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	22
104 9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	23	/*!
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	24	@class TsTaskMonitor
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	25	@ingroup publicApi
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	26	@brief TsTaskMonitor gives access to list of running tasks.
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	27
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	28	This class is one of the Qt interfaces for Task Monitor server. It can be
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	29	used to retrieve list of running tasks and receive notifications about the
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	30	changes of this list.
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	31	*/
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	32
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	33	/*!
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	34	Constructor.
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	35	*/
80 397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	36	TsTaskMonitor::TsTaskMonitor(QObject *parent) : QObject(parent), d_ptr(0)
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	37	{
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	38	d_ptr = new TsTaskMonitorPrivate(this);
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	39	}
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	40
104 9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	41	/*!
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	42	Destructor.
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	43	*/
80 397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	44	TsTaskMonitor::~TsTaskMonitor()
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	45	{
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	46	delete d_ptr;
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	47	}
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	48
104 9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	49	/*!
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	50	\return Current list of tasks from Task Monitor server.
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	51
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	52	\sa TsTask, taskListChanged()
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	53	*/
80 397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	54	QList< QSharedPointer<TsTask> > TsTaskMonitor::taskList()
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	55	{
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	56	return d_ptr->taskList();
397d00875918 Revision: 201019 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	57	}
104 9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	58
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	59	/*!
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	60	@fn TsTaskMonitor::taskListChanged()
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	61
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	62	This signal is emitted when task list changes in any way:
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	63	- the new task is started
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	64	- running task is terminated
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	65	- parameters of one task change (for example image representing the task is updated)
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	66
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	67	No data is passed within this signal, user should retrieve task list
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	68	using taskList().
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	69
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	70	\sa taskList()
9b022b1f357c Revision: 201025 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: 80 diff changeset	71	*/

author	Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
	Tue, 06 Jul 2010 14:37:10 +0300
changeset 104	9b022b1f357c
parent 80	397d00875918
permissions	-rw-r--r--