1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/os/ossrv/lowlevellibsandfws/pluginfw/Test_Bed/inc/TransitionObserver.h	Fri Jun 15 03:10:57 2012 +0200
     1.3 @@ -0,0 +1,68 @@
     1.4 +// Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
     1.5 +// All rights reserved.
     1.6 +// This component and the accompanying materials are made available
     1.7 +// under the terms of "Eclipse Public License v1.0"
     1.8 +// which accompanies this distribution, and is available
     1.9 +// at the URL "http://www.eclipse.org/legal/epl-v10.html".
    1.10 +//
    1.11 +// Initial Contributors:
    1.12 +// Nokia Corporation - initial contribution.
    1.13 +//
    1.14 +// Contributors:
    1.15 +//
    1.16 +// Description:
    1.17 +// This file contains the definition of the class MTransitionObserver
    1.18 +// 
    1.19 +//
    1.20 +
    1.21 +/**
    1.22 + @test
    1.23 +*/
    1.24 +
    1.25 +#ifndef __TRANSITIONOBSERVER_H__
    1.26 +#define __TRANSITIONOBSERVER_H__
    1.27 +
    1.28 +class CTransition;
    1.29 +
    1.30 +/**
    1.31 +	@internalAll
    1.32 +	Comments : Provides a callback method to the CUnitTest to indicate that the 
    1.33 +	specified transition has completed an asynchronous function.
    1.34 + */
    1.35 +
    1.36 +class MTransitionObserver
    1.37 +	{
    1.38 +public:
    1.39 +/**
    1.40 +	@fn				virtual void SetCurrentTransition(CTransition& aTransition) = 0
    1.41 +	Intended Usage	:	Passes the transition which is about to run.
    1.42 +					This allows transition information can be retrieved and 
    1.43 +					Repeat() can then be called on the transition.
    1.44 +	@since			7.0
    1.45 +	@param			aTransition The transition to set as current
    1.46 +	@return			void 
    1.47 +	@pre 			None
    1.48 +	@post			aTransition will be stored as a pointer to the currently executing transition
    1.49 + */
    1.50 +	
    1.51 +	virtual void SetCurrentTransition(CTransition& aTransition) = 0;
    1.52 +
    1.53 +/**
    1.54 +	@fn				virtual void Complete(CTransition& aTransition, TInt aAsyncPostCheckError) = 0
    1.55 +	Intended Usage	:	Called to indicate that an asynchronous function on the specified
    1.56 +					transition has completed.
    1.57 +	@since			7.0
    1.58 +	@param			aTransition The transition which has completed
    1.59 +	@param			aAsyncPostCheckError An error code from the second phase of post-condition
    1.60 +					validation done after the transition's asynchronous request had completed.
    1.61 +					Used for asynchronous transitions only - for synchronous transitions, 2-phase
    1.62 +					post-condition checking does not apply, and a value of KErrNone is supplied.
    1.63 +	@pre 			None
    1.64 +	@post			Depends on observer implementation.  For example, aTransition has completed, 
    1.65 +					therefore if all transitions have completed the unit test is complete.
    1.66 + */
    1.67 +	
    1.68 +	virtual void Complete(CTransition& aTransition, TInt aAsyncPostCheckError) = 0;
    1.69 +	};
    1.70 +
    1.71 +#endif