--- a/epoc32/include/calinstanceview.h	Tue Nov 24 13:55:44 2009 +0000
+++ b/epoc32/include/calinstanceview.h	Tue Mar 16 16:12:26 2010 +0000
@@ -1,1 +1,129 @@
-calinstanceview.h
+// Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
+// which accompanies this distribution, and is available
+// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+//
+
+#ifndef __CALINSTANCEVIEW_H__
+#define __CALINSTANCEVIEW_H__
+
+#include <calentry.h>
+#include <calentryview.h>
+#include <calinstanceiterator.h>
+
+class CCalFindInstanceSettings;
+class CCalInstance;
+class CCalInstanceIterator;
+class CCalInstanceViewImpl;
+class CCalSession;
+class MCalProgressCallBack;
+class TCalTime;
+class CCalLiteEntry;
+class TAgnInstanceId;
+struct TASShdAlarmedInstanceParams;
+
+/** View class for accessing instances of calendar entries.
+
+Once a session to a calendar file has been created, a view to the session
+can be created.
+
+An instance is a calendar entry, a repeated instance of a calendar entry, 
+or an RDate added to an entry.
+
+This view can be used to search for instances and also to delete instances.
+
+@publishedAll
+@released
+*/
+NONSHARABLE_CLASS(CCalInstanceView) : public CBase
+    {	
+public:
+
+	/** Parameter struct for storing search data.
+	This contains a descriptor to store search text and an enum to describe the text search behaviour.
+
+	@publishedAll
+	@released
+	*/
+	class TCalSearchParams
+		{
+	public:
+		IMPORT_C TCalSearchParams(const TDesC& aText, CalCommon::TCalSearchBehaviour aBehaviour);
+		IMPORT_C const TDesC& Text() const;
+		IMPORT_C CalCommon::TCalSearchBehaviour Behaviour() const;
+	
+	private:
+		TPtrC iSearchText;
+		CalCommon::TCalSearchBehaviour iSearchBehaviour;
+		};
+		
+	IMPORT_C static CCalInstanceView* NewL(CCalSession& aSession, MCalProgressCallBack& aProgressCallBack);
+	IMPORT_C static CCalInstanceView* NewL(CCalSession& aSession);
+	IMPORT_C ~CCalInstanceView();
+	
+	IMPORT_C void FindInstanceL(RPointerArray<CCalInstance>& aInstanceList, 
+					   			CalCommon::TCalViewFilter aCalViewFilter, 
+					   			const CalCommon::TCalTimeRange& aTimeRange) const;
+	
+	IMPORT_C void FindInstanceL(RPointerArray<CCalInstance>& aMatchedInstanceList,
+								CalCommon::TCalViewFilter aCalViewFilter, 
+								const CalCommon::TCalTimeRange& aTimeRange, 
+								const TCalSearchParams& aSearchParams) const;
+					   
+	IMPORT_C CCalInstanceIterator* FindInstanceL(const CCalFindInstanceSettings& aSettings) const;
+
+    IMPORT_C void FindAlarmedInstanceL(RPointerArray<CCalInstance>& aAlarmedInstanceList,    
+    								   TASShdAlarmedInstanceParams aAlarmedInstanceParams) const;	
+	
+	IMPORT_C void DeleteL(CCalInstance* aInstance, CalCommon::TRecurrenceRange aWhichInstances);
+								
+	IMPORT_C TCalTime NextInstanceL(CalCommon::TCalViewFilter aCalViewFilter, const TCalTime& aStartDate) const;
+	IMPORT_C TCalTime PreviousInstanceL(CalCommon::TCalViewFilter aCalViewFilter, const TCalTime& aStartDate) const;
+	
+private:
+	CCalInstanceView();
+	void ConstructL(CCalSession& aSession, MCalProgressCallBack* aProgressCallBack);
+	
+private: 
+	CCalInstanceViewImpl* iImpl;
+	};
+
+/** Class for specifying the search criteria for use in @see CCalInstanceView::FindInstanceL.
+
+@publishedPartner
+@released
+*/
+NONSHARABLE_CLASS(CCalFindInstanceSettings) : public CBase
+	{
+public:
+	IMPORT_C static CCalFindInstanceSettings* NewL(CalCommon::TCalViewFilter aFilter, const CalCommon::TCalTimeRange& aTimeRange);
+	IMPORT_C ~CCalFindInstanceSettings();
+
+	IMPORT_C void SetFilter(CalCommon::TCalViewFilter aFilter);
+	IMPORT_C void SetTimeRange(const CalCommon::TCalTimeRange& aTimeRange);
+	IMPORT_C void SetTextSearchL(const CCalInstanceView::TCalSearchParams& aSearchParams);
+	
+	CalCommon::TCalSearchBehaviour Behaviour() const;
+	CalCommon::TCalViewFilter Filter() const;
+	const CalCommon::TCalTimeRange TimeRange() const;
+	const TDesC& Text() const;
+private:
+	CCalFindInstanceSettings(CalCommon::TCalViewFilter aFilter, const CalCommon::TCalTimeRange& aTimeRange);
+
+private:
+	CalCommon::TCalTimeRange		iTimeRange;
+	CalCommon::TCalViewFilter		iFilter;
+	HBufC*							iSearchText;
+	CalCommon::TCalSearchBehaviour	iSearchBehaviour;
+	};
+	
+#endif // __CALINSTANCEVIEW_H__