/*
* 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 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:  Location triggering related system settings
*
*/


#ifndef LBTTRIGGERINGSYSTEMSETTINGS_H
#define LBTTRIGGERINGSYSTEMSETTINGS_H

#include <lbtcommon.h>

/**
 * Structure for location triggering related system settings.
 *
 * @lib lbt.lib
 *
 * @since S60 5.1
 */
class TLbtTriggeringSystemSettings
    {
public:
    /**
     * Type of system setting class.
     */
    enum TType
        {
        ///System settings
        ETypeSystemSettings     = 1,
        ///Management system settings
        ETypeManagementSystemSettings = 2
        };

    /**
     * Default constructor.
     */
    IMPORT_C TLbtTriggeringSystemSettings();
    
    /**
     * Gets the type of system setting class.
     */
    IMPORT_C virtual TType Type();

    /**
     * Returns minimum size of trigger area. 
     *
     * When creating a trigger with a circular geographical 
     * trigger area, the radius of the trigger area must be 
     * greater than this setting. 
     *
     * This function returns zero if the minimum trigger area
     * size is not set.
     *
     * @return The minimum size of trigger area. In meters.
     */
    IMPORT_C TReal MinimumTriggerAreaSize() const;

    /**
     * Sets the minum size of trigger area. This is for internal use only. 
     *
     * @panic LocTriggering ELbtErrArgument If aSize is negative.
     * @param aSize The minimum size of trigger area. In meters.
     */
    IMPORT_C void SetMinimumTriggerAreaSize(
        TReal aSize );

    /**
     * Returns the triggering mechanism state. 
     *
     * This function returns ETriggeringMechanismOn if
     * the triggering mechanism state is not set. 
     *
     * @return The triggering mechanism state. 
     */
    IMPORT_C TLbtTriggeringMechanismState 
        TriggeringMechanismState() const;

    /**
     * Sets the triggering mechanism state. This is for internal use only. 
     *
     * @param aState The triggering mechanism state.
     */
    IMPORT_C void SetTriggeringMechanismState(
        TLbtTriggeringMechanismState aState );

protected:
    /**
     * Type of the setting class
     */
    TType iType;
    
private: //data
    /**
     * The minimum size of trigger area.
     */
    TReal iMinimumTriggerAreaSize;

    /**
     * Triggering mechanism state. 
     */
    TLbtTriggeringMechanismState iTriggeringState;

    /**
     * For future use.
     */
    TUint8 iUnused[8];
    };

#endif //LBTCOMMON_H