--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/phonebookui/Phonebook/Engine/inc/CPbkIdleProcessRunner.h Tue Feb 02 10:12:17 2010 +0200
@@ -0,0 +1,115 @@
+/*
+* Copyright (c) 2002 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+* Executes a MPbkBackgroundProcess in an idle loop.
+*
+*/
+
+
+#ifndef __CPBKIDLEPROCESSRUNNER_H__
+#define __CPBKIDLEPROCESSRUNNER_H__
+
+// INCLUDES
+#include <e32base.h>
+
+// FORWARD DECLARATIONS
+class MPbkBackgroundProcess;
+class MPbkProcessObserver;
+
+// CLASS DECLARATION
+
+/**
+ * Executes a MPbkBackgroundProcess in an idle loop.
+ */
+NONSHARABLE_CLASS(CPbkIdleProcessRunner) :
+ public CBase
+ {
+ public: // Constructors and destructor
+ /**
+ * Creates a new instance of this class.
+ * @param aPriority desired priority of the active object
+ */
+ static CPbkIdleProcessRunner* NewL(TInt aPriority);
+
+ /**
+ * Destructor.
+ */
+ ~CPbkIdleProcessRunner();
+
+ public: // Interface
+ /**
+ * Executes aProcess asynchronously in an idle loop.
+ *
+ * @param aProcess process to execute.
+ * @param aObserver process observer.
+ */
+ void Execute
+ (MPbkBackgroundProcess& aProcess, MPbkProcessObserver* aObserver);
+
+ /**
+ * Executes aProcess in an idle loop. This function returns when the
+ * process completes or is interrupted.
+ *
+ * @param aProcess process to execute.
+ * @exception any error when executing the process.
+ */
+ void SynchronousExecuteL
+ (MPbkBackgroundProcess& aProcess);
+
+ /**
+ * Cancels current execution.
+ */
+ void Cancel();
+
+ private: // Implementation
+ CPbkIdleProcessRunner(TInt aPriority);
+
+ class CRunner : public CActive
+ {
+ public: // Interface
+ CRunner(TInt aPriority);
+ ~CRunner();
+ void Start
+ (MPbkBackgroundProcess& aProcess,
+ MPbkProcessObserver* aObserver);
+ void RunSyncL(MPbkBackgroundProcess& aProcess);
+ void Stop();
+
+ private: // from CActive
+ void DoCancel();
+ void RunL();
+ TInt RunError(TInt aError);
+
+ private: // Implementation
+ void ProcessFinished();
+ void ProcessCanceled();
+ void Finalize(MPbkBackgroundProcess* aProcess);
+ void IssueRequest();
+
+ private: // Data
+ MPbkBackgroundProcess* iProcess;
+ MPbkProcessObserver* iObserver;
+ TInt* iProcessError;
+ CActiveSchedulerWait iActiveWait;
+ };
+
+ private: // Data
+ /// Own: the active object
+ CRunner iRunner;
+ };
+
+
+#endif // __CPBKIDLEPROCESSRUNNER_H__
+
+// End of File