locsrv_pub/location_triggering_api/inc/lbttriggerconditionbase.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Tue, 14 Sep 2010 22:09:33 +0300
branchRCL_3
changeset 22 fce0ae2e4223
parent 0 667063e416a2
permissions -rw-r--r--
Revision: 201033 Kit: 201035

/*
* Copyright (c) 2006 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:  Abstract base class for trigger condition classes.
*
*/




#ifndef LBTTRIGGERCONDITIONBASE_H
#define LBTTRIGGERCONDITIONBASE_H

#include <e32base.h>
#include <s32strm.h>

/**
 * Abstract base class for trigger condition classes.
 * 
 * This class is not meant to be derived nor instantiated by client application.
 * It defines methods that concrete trigger condition class must implement.
 *
 * @lib lbt.lib
 * @since S60 5.1
 */
class CLbtTriggerConditionBase : public CBase
    {
public:
    /**
     * Enumeration for trigger condition types.
     */
    enum TType
        {
        /** 
         * Trigger condition based on geographical area and movement of 
         * the terminal. A trigger is fired when the 
         * terminal enters or leaves the specified trigger area.
         */
        ETriggerConditionArea = 1
        };
        
    /**
     * Destructor
     */
    virtual ~CLbtTriggerConditionBase();
    
    /**
     * Gets the type of trigger condition class.
     * @return The type of trigger condition class.
     */
    virtual TType Type() const = 0;
    
    /**
     * Internalizes the trigger condition object's details and attributes 
     * from stream.
     *
     * The presence of this function means that the standard templated 
     * operator>>() ( defined in s32strm.h ) is available to internalize objects 
     * of this class.
     *
     * @param[in] aStream Stream from which the object should be internalized.
     */
    IMPORT_C void InternalizeL( RReadStream& aStream );
    
    /**
     * Externalizes the trigger condition object's details and attributes
     * to stream.
     *
     * The presence of this function means that the standard templated 
     * operator<<() ( defined in s32strm.h ) is available to externalize objects 
     * of this class.
     *
     * @param[in] aStream Stream to which the object should be externalized.
     */
    IMPORT_C void ExternalizeL( RWriteStream& aStream ) const;
    
protected:
    /**
     * Constructor
     */
    CLbtTriggerConditionBase();
    
    /**
     * Internalize method that subclass must implement.
     * @param[in] aStream Stream from which the object should be internalized.
     */
    virtual void DoInternalizeL( RReadStream& aStream ) = 0;
    
    /**
     * Externalize method that subclass must implement.
     * @param[in] aStream Stream to which the object should be externalized.
     */
    virtual void DoExternalizeL( RWriteStream& aStream ) const = 0;

private:
    /**
     * By default, prohibit copy constructor
     */
    CLbtTriggerConditionBase( const CLbtTriggerConditionBase& );
    
    /**
     * Prohibit assigment operator
     */
    CLbtTriggerConditionBase& operator= ( const CLbtTriggerConditionBase& );

    };
    
 
#endif // LBTTRIGGERCONDITIONBASE_H