/*

 * 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:  Data class for trigger's dynamic system information.

 *

 */

 #ifndef LBTTRIGGERDYNAMICINFO_H

 #define LBTTRIGGERDYNAMICINFO_H

 #include <lbtcommon.h>

 /**

  * Data class for trigger's dynamic system information, such as 

  * trigger validity and distance to the latest acquired location.

  * 

  * Client application can get following dynamic information of a trigger

  * after it's created. 

  *

  * -  <B>Validity</B>. A trigger is set as invalid when the specified 

  * manager UI, owner process or trigger handling process( for start-up trigger )

  * is removed from the system. The process can be removed for example when 

  * it resides in removable media( like MMC ), and that media is removed from 

  * the terminal. An invalid trigger is not included in the 

  * trigger supervision process. When the removable media with the specified

  * process is attached back to the terminal, the trigger is set as 

  * valid and included in the trigger supervision process, provided 

  * that the trigger is not disabled. When a trigger has been invalid longer

  * than the system clean-up time, the trigger is removed from the system.  

  * The system clean-up time is defined by the system and can't be accessed

  * by client application. Note, if a trigger's owner process, manager UI

  * or trigger handling process( for start-up trigger ) is uninstalled

  * from the system, the trigger will be removed by Location Triggering

  * Server.

  *

  * -  <B>Distance to the Latest Acquired Location</B>. 

  *

  *  @lib lbt.lib

  *  @since S60 5.1

  */

 struct TLbtTriggerDynamicInfo

     {

     /**

      * Attributes of a trigger's dynamic information.

      */

     enum TLbtDynamicInfoAttribute

         {

         /**

          * Validity status attribute.

          */

         EValidityStatus = 0x01,           

         /**

          * Distance to latest acquired location fix.

          */ 

         EDistanceToLatestLocation = 0x02,

         /**

          * Last fired location information.

          */

         EFiredLocality = 0x04   

         };

     /**

      * Defines the trigger validity status.

      */

     enum TLbtTriggerValidity

         {

         /**

          * Invalid

          */

         EInvalid = 1,       

         /**

          * Valid

          */

         EValid = 2          

         };

     /**

      * Defines the trigger validity status.

      */

     TLbtTriggerValidity iValidity;

     /**

      * The distance in meters from the trigger to latest acquired

      * location.

      */

     TReal iDistanceToLatestLocation;

     /**

      * Information of the location where the trigger was last fired. The 

      * information available will contain the latitude, longitude and 

      * horizontal accuracy values. Other details in TLocality will not 

      * be updated.

      */

     TLocality iFiredLocality;

     /**

      * For future use

      */

     TUint8 iUnused[8];

     };

 #endif // LBTTRIGGERDYNAMICINFO_H