epoc32/include/app/cntview.h
branchSymbian3
changeset 4 837f303aceeb
parent 3 e1b950c65cb4
equal deleted inserted replaced
3:e1b950c65cb4 4:837f303aceeb
     1 // Copyright (c) 2001-2009 Nokia Corporation and/or its subsidiary(-ies).
     1 // Copyright (c) 2001-2009 Nokia Corporation and/or its subsidiary(-ies).
     2 // All rights reserved.
     2 // All rights reserved.
     3 // This component and the accompanying materials are made available
     3 // This component and the accompanying materials are made available
     4 // 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
     4 // under the terms of "Eclipse Public License v1.0"
     5 // which accompanies this distribution, and is available
     5 // which accompanies this distribution, and is available
     6 // at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
     6 // at the URL "http://www.eclipse.org/legal/epl-v10.html".
     7 //
     7 //
     8 // Initial Contributors:
     8 // Initial Contributors:
     9 // Nokia Corporation - initial contribution.
     9 // Nokia Corporation - initial contribution.
    10 //
    10 //
    11 // Contributors:
    11 // Contributors:
    20 
    20 
    21 /** The maximum length of the string used by contact sub view ranges to find the 
    21 /** The maximum length of the string used by contact sub view ranges to find the 
    22 item at the upper or lower limit of the range.
    22 item at the upper or lower limit of the range.
    23 
    23 
    24 In practice, only the first character in the string is used and this value 
    24 In practice, only the first character in the string is used and this value 
    25 is ignored. */
    25 is ignored. 
       
    26 @publishedAll
       
    27 @released
       
    28 */
    26 const TInt KMaxBoundaryMatchLength=8;
    29 const TInt KMaxBoundaryMatchLength=8;
    27 
    30 
    28 class CContactGroupView: public CContactViewBase, public MContactViewObserver
    31 class CContactGroupView: public CContactViewBase, public MContactViewObserver
    29 /** Provides a view of a group of contact items.
    32 /** Provides a view of a group of contact items.
    30 
    33 
   273 	of the range. */
   276 	of the range. */
   274 	TInt iLow;
   277 	TInt iLow;
   275 	/** The index into the sub view's underlying view of the item at the upper limit 
   278 	/** The index into the sub view's underlying view of the item at the upper limit 
   276 	of the range. */
   279 	of the range. */
   277 	TInt iHigh;
   280 	TInt iHigh;
   278 	//ChrisD: contain by value not ptr
       
   279 	/** The collation method used to sort the strings.
   281 	/** The collation method used to sort the strings.
   280 	
   282 	
   281 	By default, this is the standard collation method for the current locale. */
   283 	By default, this is the standard collation method for the current locale. */
   282 	TCollationMethod* iCollateMethod;
   284 	TCollationMethod* iCollateMethod;
   283 	};
   285 	};
   324 	IMPORT_C static CContactViewLowRange* NewL(const CContactViewBase& aView,const TDesC& aMatch,TCriteria aCriteria);
   326 	IMPORT_C static CContactViewLowRange* NewL(const CContactViewBase& aView,const TDesC& aMatch,TCriteria aCriteria);
   325 private: // From CContactViewRangeBase.
   327 private: // From CContactViewRangeBase.
   326 	void SetL();
   328 	void SetL();
   327 private:
   329 private:
   328 	CContactViewLowRange(const CContactViewBase& aView,const TDesC& aMatch,TCriteria aCriteria);
   330 	CContactViewLowRange(const CContactViewBase& aView,const TDesC& aMatch,TCriteria aCriteria);
   329 //ChrisD: why private d'tor
       
   330 	~CContactViewLowRange();
   331 	~CContactViewLowRange();
   331 private:
   332 private:
   332 	TBuf<KMaxBoundaryMatchLength> iMatch;
   333 	TBuf<KMaxBoundaryMatchLength> iMatch;
   333 	TCriteria iCriteria;
   334 	TCriteria iCriteria;
   334 	};
   335 	};
   349 	IMPORT_C static CContactViewHighRange* NewL(const CContactViewBase& aView,const TDesC& aMatch,TCriteria aCriteria);
   350 	IMPORT_C static CContactViewHighRange* NewL(const CContactViewBase& aView,const TDesC& aMatch,TCriteria aCriteria);
   350 private: // From CContactViewRangeBase.
   351 private: // From CContactViewRangeBase.
   351 	void SetL();
   352 	void SetL();
   352 private:
   353 private:
   353 	CContactViewHighRange(const CContactViewBase& aView,const TDesC& aMatch,TCriteria aCriteria);
   354 	CContactViewHighRange(const CContactViewBase& aView,const TDesC& aMatch,TCriteria aCriteria);
   354 //ChrisD: why private d'tor
       
   355 	~CContactViewHighRange();
   355 	~CContactViewHighRange();
   356 private:
   356 private:
   357 	TBuf<KMaxBoundaryMatchLength> iMatch;
   357 	TBuf<KMaxBoundaryMatchLength> iMatch;
   358 	TCriteria iCriteria;
   358 	TCriteria iCriteria;
   359 	};
   359 	};
   394 	TContactViewPreferences ContactViewPreferences();
   394 	TContactViewPreferences ContactViewPreferences();
   395 	const RContactViewSortOrder& SortOrderL() const;
   395 	const RContactViewSortOrder& SortOrderL() const;
   396 private: // From MContactViewObserver.
   396 private: // From MContactViewObserver.
   397 	virtual void HandleContactViewEvent(const CContactViewBase& aView,const TContactViewEvent& aEvent);
   397 	virtual void HandleContactViewEvent(const CContactViewBase& aView,const TContactViewEvent& aEvent);
   398 private:
   398 private:
   399 //ChrisD: why private d'tor
       
   400 	~CContactSubView();
   399 	~CContactSubView();
   401 	CContactSubView(const CContactDatabase& aDb,CContactViewBase& aView);
   400 	CContactSubView(const CContactDatabase& aDb,CContactViewBase& aView);
   402 	CContactSubView(const CContactDatabase& aDb,const CContactSubView& aView);
   401 	CContactSubView(const CContactDatabase& aDb,const CContactSubView& aView);
   403 	void CommonConstructL(MContactViewObserver& aObserver);
   402 	void CommonConstructL(MContactViewObserver& aObserver);
   404 	void ConstructL(MContactViewObserver& aObserver,const TDesC& aBoundary);
   403 	void ConstructL(MContactViewObserver& aObserver,const TDesC& aBoundary);