1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/os/graphics/windowing/windowserver/inc/WSGRAPHICDRAWERARRAY.H	Fri Jun 15 03:10:57 2012 +0200
     1.3 @@ -0,0 +1,82 @@
     1.4 +// Copyright (c) 2005-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 +// Utility class for indexing instances of CWsGraphicDrawer
    1.18 +// 
    1.19 +//
    1.20 +
    1.21 +#ifndef __WSGRAPHICDRAWERARRAY_H__
    1.22 +#define __WSGRAPHICDRAWERARRAY_H__
    1.23 +
    1.24 +#include <e32base.h>
    1.25 +#include <graphics/wsgraphicdrawer.h>
    1.26 +
    1.27 +class CWsGraphicDrawerArray: public CBase
    1.28 +/** An index of CWsGraphicDrawer instances
    1.29 +A CWsGraphicDrawer can be in many such indexes, as an index does not imply ownership
    1.30 +@publishedPartner
    1.31 +@released
    1.32 +*/	{
    1.33 +public:
    1.34 +	//Placeholder for transacion record
    1.35 +	struct XRollBackBase;
    1.36 +	
    1.37 +	//transactional manipulation methods that are deprecated because they leak 
    1.38 +	IMPORT_C void AddLC(CWsGraphicDrawer* aDrawer);
    1.39 +	IMPORT_C TInt SwapLC(CWsGraphicDrawer* aDrawer);
    1.40 +	
    1.41 +	//non-transactional manipulation
    1.42 +	IMPORT_C TInt Remove(const TGraphicDrawerId& aId);
    1.43 +	IMPORT_C TInt Add(CWsGraphicDrawer* aDrawer);
    1.44 +	IMPORT_C TInt Swap(CWsGraphicDrawer* aDrawer);
    1.45 +	
    1.46 +	//safe transactional methods
    1.47 +	//The array should not be Compressed() during the transaction period to ensure that the Remove RollBack operation will always succeed.
    1.48 +	IMPORT_C XRollBackBase* AddTLC(CWsGraphicDrawer* aDrawer);
    1.49 +	IMPORT_C XRollBackBase* SwapTLC(CWsGraphicDrawer* aDrawer);
    1.50 +	IMPORT_C XRollBackBase* RemoveTLC(const TGraphicDrawerId& aId);
    1.51 +	IMPORT_C void CommitP(XRollBackBase*);
    1.52 +
    1.53 +	//Query
    1.54 +	IMPORT_C const CWsGraphicDrawer* ResolveGraphic(const TGraphicDrawerId& aId) const;
    1.55 +	IMPORT_C TBool IsEmpty() const;
    1.56 +
    1.57 +	//Other non-transactional methods
    1.58 +	IMPORT_C TInt RemoveAndDestroy(const TGraphicDrawerId& aId);
    1.59 +	IMPORT_C TInt RemoveAll(const MWsClient& aOwner);
    1.60 +	IMPORT_C TInt RemoveAndDestroyAll(const MWsClient& aOwner);
    1.61 +	IMPORT_C void Close();
    1.62 +	IMPORT_C void ResetAndDestroy();
    1.63 +private:
    1.64 +	NONSHARABLE_STRUCT(TGraphic)
    1.65 +		{
    1.66 +		TGraphicDrawerId iId;
    1.67 +		CWsGraphicDrawer* iDrawer;
    1.68 +		};
    1.69 +	RArray<TGraphic> iArray;
    1.70 +	CWsGraphicDrawer* SwapIn(CWsGraphicDrawer* aDrawer);
    1.71 +	TInt IndexOf(const TGraphicDrawerId& aId) const;
    1.72 +	static TInt GraphicDrawerCompare(const TGraphic& aFirst,const TGraphic& aSecond);
    1.73 +private:
    1.74 +	//Transactional unwinding support classes
    1.75 +	class XAddRollBack;
    1.76 +	friend class XAddRollBack;
    1.77 +	class XSwapRollBack;
    1.78 +	friend class XSwapRollBack;
    1.79 +	class XRemoveRollBack;
    1.80 +	friend class XRemoveRollBack;
    1.81 +	class testArrayValidator;
    1.82 +	friend class testArrayValidator;
    1.83 +	};
    1.84 +
    1.85 +#endif //#ifndef __WSGRAPHICDRAWERARRAY_H__