diff -r 000000000000 -r 2e3d3ce01487 contextframework/cfw/inc/basicoperationsplugin/cfinrange.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/contextframework/cfw/inc/basicoperationsplugin/cfinrange.h Tue Feb 02 10:12:00 2010 +0200 @@ -0,0 +1,158 @@ +/* +* Copyright (c) 2004-2008 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: CCFInRange class declaration. Currently supports the following +* (cep) types: +* "cep:int" +* "cep:string" +* "cep:double" +* "cep:position" +* "cep:date" +* +*/ + + + +#ifndef C_CFINRANGE_H +#define C_CFINRANGE_H + + +// INCLUDES +#include "cfcontextoperation.h" + +#include + +// FORWARD DECLARATIONS +class CCFContextObject; + +// CLASS DECLARATION + +/** +* This class implements InRange -operation on Context Framework Scripts. +* +* @lib CFScriptEngine +* @since Series 60 2.6 +*/ +NONSHARABLE_CLASS( CCFInRange ): public CCFContextOperation + { +public: // Constructors and destructor + + /** + * Creates a CCFInRange object + * @param aServices is the operation services interface for nodes. + * @param aParent is parent node for this node. + * @param aName is name of the context object this operation operates on. + * @param aSource is the source of the context object this operation + * operates on. + * @param aType is the interpretation of aCmpVal + * @param aMinVal is a string representation of the minimum comparison value + * @param aMinVal is a string representation of the maximum comparison value + * @return a pointer to the created instance of CCFInRange + */ + static CCFInRange* NewL( MCFOperationServices& aServices, + CCFOperationNode* aParent, + TDesC& aName, + TDesC& aSource, + const CCFContextOperation::TCmpType aType, + const TDesC& aMinVal, + const TDesC& aMaxVal ); + + /** + * Creates a CCFInRange object + * @param aServices is the operation services interface for nodes. + * @param aParent is parent node for this node. + * @param aName is name of the context object this operation operates on. + * @param aSource is the source of the context object this operation + * operates on. + * @param aType is the interpretation of aCmpVal + * @param aMinVal is a string representation of the minimum comparison value + * @param aMinVal is a string representation of the maximum comparison value + * @return a pointer to the created instance of CCFInRange + */ + static CCFInRange* NewLC( MCFOperationServices& aServices, + CCFOperationNode* aParent, + TDesC& aName, + TDesC& aSource, + const CCFContextOperation::TCmpType aType, + const TDesC& aMinVal, + const TDesC& aMaxVal ); + + /** + * Creates and parses a CCFInRange instance from an xml node. + * @param aServices is the operation services interface for nodes. + * @param aParent is the parent of this node or NULL if this is a root. + * The ownership of the parent is not transferred. + * @param aNode is the node to be parsed. + * @return a pointer to the created instance of CCFInRange, or NULL if the + * node is not this in range node. May leave with any system wide error + * code. + */ + static CCFInRange* ParseL( MCFOperationServices& aServices, + CCFOperationNode* aParent, + CMDXMLNode& aNode ); + + /** + * Destructor. + */ + ~CCFInRange(); + +private: + + /** + * C++ default constructor. + */ + CCFInRange( MCFOperationServices& aServices, + CCFOperationNode* aParent, + HBufC* aName, + HBufC* aSource, + const CCFContextOperation::TCmpType aType ); + + /** + * By default Symbian 2nd phase constructor is private. + */ + void ConstructL( const TDesC& aMinVal, const TDesC& aMaxVal ); + +protected: // From CCFContextOperation + + /** + * Returns ETrue if this operation is true. + */ + TBool IsTrueL( const CCFContextObject& aContextObject ); + +private: // New functions + + /** + * Method that takes two GPS positions as (latitude,longitude)-pairs + * (units==DEGREES) and calculates their ellipsoid distance. + * This is used in calculation of the value for cep:position types. + * NOTE: This algorithm can be found from the following book: + * "Astronomical Algorithms" by Jean Meeus. + * @param aPos1Latitude latitude of point one in degrees. + * @param aPos1Longitude longitude of point one in degrees. + * @param aPos2Latitude latitude of point two in degrees. + * @param aPos2Longitude longitude of point two in degrees. + * @return calculated distance (in meters) if successful, + * otherwise KErrGeneral. + */ + TReal EllipsoidDistanceBetweenTwoPositions( + TReal aPos1Latitude, TReal aPos1Longitude, + TReal aPos2Latitude, TReal aPos2Longitude ); + +private: // Data + + CCFContextOperation::TCmpType iType; + HBufC* iMinVal; + HBufC* iMaxVal; + }; + +#endif // C_CFINRANGE_H