williamr@2: /*
williamr@2: * Copyright (c) 2006 Nokia Corporation and/or its subsidiary(-ies).
williamr@2: * All rights reserved.
williamr@2: * This component and the accompanying materials are made available
williamr@4: * under the terms of "Eclipse Public License v1.0"
williamr@2: * which accompanies this distribution, and is available
williamr@4: * at the URL "http://www.eclipse.org/legal/epl-v10.html".
williamr@2: *
williamr@2: * Initial Contributors:
williamr@2: * Nokia Corporation - initial contribution.
williamr@2: *
williamr@2: * Contributors:
williamr@2: *
williamr@2: * Description:  Data class for trigger's dynamic system information.
williamr@2: *
williamr@2: */
williamr@2: 
williamr@2: 
williamr@2: #ifndef LBTTRIGGERDYNAMICINFO_H
williamr@2: #define LBTTRIGGERDYNAMICINFO_H
williamr@2: 
williamr@2: #include <lbtcommon.h>
williamr@2: 
williamr@2: /**
williamr@2:  * Data class for trigger's dynamic system information, such as 
williamr@2:  * trigger validity and distance to the latest acquired location.
williamr@2:  * 
williamr@2:  * Client application can get following dynamic information of a trigger
williamr@2:  * after it's created. 
williamr@2:  *
williamr@2:  * -  <B>Validity</B>. A trigger is set as invalid when the specified 
williamr@2:  * manager UI, owner process or trigger handling process( for start-up trigger )
williamr@2:  * is removed from the system. The process can be removed for example when 
williamr@2:  * it resides in removable media( like MMC ), and that media is removed from 
williamr@2:  * the terminal. An invalid trigger is not included in the 
williamr@2:  * trigger supervision process. When the removable media with the specified
williamr@2:  * process is attached back to the terminal, the trigger is set as 
williamr@2:  * valid and included in the trigger supervision process, provided 
williamr@2:  * that the trigger is not disabled. When a trigger has been invalid longer
williamr@2:  * than the system clean-up time, the trigger is removed from the system.  
williamr@2:  * The system clean-up time is defined by the system and can't be accessed
williamr@2:  * by client application. Note, if a trigger's owner process, manager UI
williamr@2:  * or trigger handling process( for start-up trigger ) is uninstalled
williamr@2:  * from the system, the trigger will be removed by Location Triggering
williamr@2:  * Server.
williamr@2:  *
williamr@2:  * -  <B>Distance to the Latest Acquired Location</B>. 
williamr@2:  *
williamr@2:  *  @lib lbt.lib
williamr@2:  *  @since S60 5.1
williamr@2:  */
williamr@2: struct TLbtTriggerDynamicInfo
williamr@2:     {
williamr@2:     /**
williamr@2:      * Attributes of a trigger's dynamic information.
williamr@2:      */
williamr@2:     enum TLbtDynamicInfoAttribute
williamr@2:         {
williamr@2:         /**
williamr@2:          * Validity status attribute.
williamr@2:          */
williamr@2:         EValidityStatus = 0x01,           
williamr@2:         
williamr@2:         /**
williamr@2:          * Distance to latest acquired location fix.
williamr@2:          */ 
williamr@2:         EDistanceToLatestLocation = 0x02,
williamr@2:         
williamr@2:         /**
williamr@2:          * Last fired location information.
williamr@2:          */
williamr@2:         EFiredLocality = 0x04   
williamr@2:         };
williamr@2:     
williamr@2:     /**
williamr@2:      * Defines the trigger validity status.
williamr@2:      */
williamr@2:     enum TLbtTriggerValidity
williamr@2:         {
williamr@2:         /**
williamr@2:          * Invalid
williamr@2:          */
williamr@2:         EInvalid = 1,       
williamr@2:         /**
williamr@2:          * Valid
williamr@2:          */
williamr@2:         EValid = 2          
williamr@2:         };
williamr@2: 
williamr@2:     /**
williamr@2:      * Defines the trigger validity status.
williamr@2:      */
williamr@2:     TLbtTriggerValidity iValidity;
williamr@2: 
williamr@2:     /**
williamr@2:      * The distance in meters from the trigger to latest acquired
williamr@2:      * location.
williamr@2:      */
williamr@2:     TReal iDistanceToLatestLocation;
williamr@2:     
williamr@2:     /**
williamr@2:      * Information of the location where the trigger was last fired. The 
williamr@2:      * information available will contain the latitude, longitude and 
williamr@2:      * horizontal accuracy values. Other details in TLocality will not 
williamr@2:      * be updated.
williamr@2:      */
williamr@2:     TLocality iFiredLocality;
williamr@2: 
williamr@2:     /**
williamr@2:      * For future use
williamr@2:      */
williamr@2:     TUint8 iUnused[8];
williamr@2:     };
williamr@2: 
williamr@2: #endif // LBTTRIGGERDYNAMICINFO_H