1 // Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
2 // All rights reserved.
3 // This component and the accompanying materials are made available
4 // under the terms of "Eclipse Public License v1.0"
5 // which accompanies this distribution, and is available
6 // at the URL "http://www.eclipse.org/legal/epl-v10.html".
8 // Initial Contributors:
9 // Nokia Corporation - initial contribution.
14 // This file contains the definition of the class MTransitionObserver
22 #ifndef __TRANSITIONOBSERVER_H__
23 #define __TRANSITIONOBSERVER_H__
29 Comments : Provides a callback method to the CUnitTest to indicate that the
30 specified transition has completed an asynchronous function.
33 class MTransitionObserver
37 @fn virtual void SetCurrentTransition(CTransition& aTransition) = 0
38 Intended Usage : Passes the transition which is about to run.
39 This allows transition information can be retrieved and
40 Repeat() can then be called on the transition.
42 @param aTransition The transition to set as current
45 @post aTransition will be stored as a pointer to the currently executing transition
48 virtual void SetCurrentTransition(CTransition& aTransition) = 0;
51 @fn virtual void Complete(CTransition& aTransition, TInt aAsyncPostCheckError) = 0
52 Intended Usage : Called to indicate that an asynchronous function on the specified
53 transition has completed.
55 @param aTransition The transition which has completed
56 @param aAsyncPostCheckError An error code from the second phase of post-condition
57 validation done after the transition's asynchronous request had completed.
58 Used for asynchronous transitions only - for synchronous transitions, 2-phase
59 post-condition checking does not apply, and a value of KErrNone is supplied.
61 @post Depends on observer implementation. For example, aTransition has completed,
62 therefore if all transitions have completed the unit test is complete.
65 virtual void Complete(CTransition& aTransition, TInt aAsyncPostCheckError) = 0;