diff -r 2fe1408b6811 -r e1b950c65cb4 epoc32/include/calinstanceview.h --- a/epoc32/include/calinstanceview.h Tue Mar 16 16:12:26 2010 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,129 +0,0 @@ -// 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 -#include -#include - -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& aInstanceList, - CalCommon::TCalViewFilter aCalViewFilter, - const CalCommon::TCalTimeRange& aTimeRange) const; - - IMPORT_C void FindInstanceL(RPointerArray& 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& 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__