// under the terms of "Eclipse Public License v1.0"

// at the URL "http://www.eclipse.org/legal/epl-v10.html".

// System Includes

// User Includes

#ifndef SYMBIAN_ENABLE_SPLIT_HEADERS

/**

 * The Alarm publish and subscribe category

 * 

 * @publishedPartner

 * @released

 */

/**

 * Used for subcribing missed alarms or time zone changes

 * @publishedPartner

 * @released

 */

/**

 * The publish and subscribe data for KMissingAlarmPubSubKey

 * @publishedPartner

 * @released

 */

	/**

	 * The value indicating the changes.

	 * 1 - Time zone has been changes but there are no missed alarms

	 * 2 - Some alarms have been missed after system time or time zone has changed.

	 */

	/**

	 * The time that system time change took place, in universal (UTC) time 

	 */

#ifdef SYMBIAN_SKIPPED_CALENDAR_ALARMS

/**

 * Used for subscribing to data used when searching for instances in Calendar

 * @publishedPartner

 * @released

 */

/**

 * The publish and subscribe data for KMissingAlarmInstancesPubSubKey

 * @publishedPartner

 * @released

 */

	/**

	 * The start of the time range in local time.

	 */ 

	/**

	 * The end of the time range in local time.

	 */

	/**

	 * The alarm time types to include.

	 */

#endif //SYMBIAN_SKIPPED_CALENDAR_ALARMS

#endif //SYMBIAN_ENABLE_SPLIT_HEADERS

#ifdef SYMBIAN_SYSTEM_STATE_MANAGEMENT

/**

 * Used for subcribing wake-up alarm set and unset notifications

 * Belonging to the KAlarmServerPubSubCategory alarm publish and subscribe category

 * 

 * @publishedPartner

 * @released

 */

const TUint KWakeupAlarmPubSubKey = 102;

/**

 * Alarm server sets KWakeupAlarmPubSubKey value to EActiveWakeupAlarmSet when there is an active

 * wakeup alarm in the alarm queue otherwise sets it to EActiveNoWakeupAlarmsSet. 

 * A wakeup alarm starts the device if it is powered off when the alarm expires. If 

 * the device is in normal mode then it works as a clock alarm.      

 * An active wakeup alarm is a wakeup alarm which has been set and has not started to alert yet.

 *  

 * EActiveWakeupAlarmUninitialized is used to notify the listeners of 'KWakeupAlarmPubSubKey' 

 * key that the Alarm Server has just started at the device boot time and it needs to internalize 

 * Alarm Queue from backup before checking for the presence of active wake-up alarm. 

 *  

 * @publishedPartner

 * @released

 */

enum TActiveWakeupAlarmStatus

    {

    EActiveWakeupAlarmUninitialized = 100,

    EActiveWakeupAlarmSet,

    EActiveNoWakeupAlarmsSet,

    };

#endif

/**

 * A client-side alarm object.

 * 

 * It contains all of the information needed to create an alarm in the Alarm Server.

 * 

 * @publishedAll

 * @released

 */

class TASShdAlarm

public:										

public:										

public:								

    // Read-Only Access

    /**

     * Returns the alarm status.

     * 

     * @return Alarm status.

     */

	inline TAlarmStatus	Status() const { return iStatus; }

	/**

	 * Returns the alarm state.

	 * 

	 * @return Alarm state.

	 */

	inline TAlarmState State() const { return iState; }

	IMPORT_C TBool HasAssociatedData() const;

	IMPORT_C TBool HasOwningSession() const;

	IMPORT_C TBool HasBecomeOrphaned() const;

public:								

    /**

     * Returns a writable version of the alarm's unique identifier.

     * 

     * @return Reference to the unique identifier.

     */

	inline TAlarmId& Id() { return iAlarmId; }

	/**

	 * Return the alarm's unique identifier.

	 * 

	 * @return The unique identifier.

	 */

	inline TAlarmId	Id() const { return iAlarmId; }

	/**

	 * The Secure ID is only used in the secured platform

	 */ 

	inline void SetSid(const TSecureId& aSecureID) {iTASShdAlarmSID = aSecureID;}

	//	returns the SID of the alarm's creator

	inline TSecureId GetSid() const {return iTASShdAlarmSID;}

    /**

     * Returns a writable version of the next time the alarm is scheduled to expire.

     * 

     * @return Next expiry time.

     */

	inline TTime& NextDueTime() { return iNextDueTime; }

    /**

     * Returns the next time that the alarm is scheduled to expire.

     * 

     * @return Next expiry time.

     */

	inline const TTime&	NextDueTime() const { return iNextDueTime; }

    /**

     * Returns a writable version of the alarm's original expiry time.

     * 

     * @return Original expiry time.

     */

	inline TTime& OriginalExpiryTime() { return iOriginalExpiryTime; }

    /**

     * Returns the alarm's original expiry time.

     * 

     * The original expiry time is the same as the next due time, unless the alarm

     * has been snoozed. In that case, the original expiry time is the time when

     * the alarm first expired, and the next due time is when it is to re-awaken

     * after the snooze.

     * 

     * @return Original expiry time.

     */

	inline const TTime& OriginalExpiryTime() const { return iOriginalExpiryTime; }

    /**

     * Returns a writable version of the alarm's category.

     * 

     * Clients can use the category to tag each alarm with a specific code. This

     * allows clients to identify all related alarms, such as all alarms associated

     * with a particular application or application engine.

     * 

     * @return Alarm category.

     */

	inline TAlarmCategory& Category() { return iCategory; }

    /**

     * Return this alarm's category.

     * 

     * @return Alarm category.

     */

	inline TAlarmCategory Category() const { return iCategory; }

    /**

     * Returns a writable version of the alarm's characteristics.

     * 

     * @return Alarm characteristics bit flags.

     */

	inline TAlarmCharacteristicsFlags& Characteristics() { return iCharacteristics; }

    /**

     * Returns the alarm's characteristics

     * 

     * @return Alarm characteristics bit flags.

     */

	inline TAlarmCharacteristicsFlags Characteristics() const { return iCharacteristics; }

    /**

     * Returns a writable version of the alarm's repeat definition.

     * 

     * The repeat definition controls the alarm's behaviour after it has expired.

     * For example, you can set the repeat definition so that the server automatically

     * queues the alarm to expire again in exactly 24 hours time.

     * 

     * @return Alarm repeat definition.

     */

	inline TAlarmRepeatDefinition& RepeatDefinition() { return iRepeatDefinition; }

    /**

     * Returns the repeat definition for the alarm.

     * 

     * @return The alarm's repeat definition.

     */

	inline TAlarmRepeatDefinition RepeatDefinition() const { return iRepeatDefinition; }

    /**

     * Returns a writable version of the alarm's message.

     * 

     * The message is usually displayed in the application UI when the alarm expires.

     * 

     * @return Reference to the alarm's associated message.

     */

	inline TAlarmMessage& Message() { return iMessage; }

    /**

     * Returns the alarm's message.

     * 

     * The message is usually displayed in the application UI when the alarm expires.

     * 

     * @return Reference to the alarm's associated message.

     */

	inline const TAlarmMessage& Message() const { return iMessage; }

    /**

     * Return a writable version of the alarm sound's filename.

     * 

     * @return Reference to the alarm's sound filename.

     */

	inline TAlarmSoundName& SoundName() { return iSoundName; }

    /**

     * Returns the alarm's sound filename.

     * 

     * @return Sound filename.

     */

	inline const TAlarmSoundName& SoundName() const { return iSoundName; }

    /**

     * Returns the alarm session type.

     * 

     * @return Alarm session type.

     */

	inline TAlarmDayOrTimed DayOrTimed() const { return iDayOrTimed; }

    /**

     * Returns a writable version of the alarm type, i.e. day, timed

     * 

     * @return iDayOrTimed.

     */ 

	inline TAlarmDayOrTimed& DayOrTimed() { return iDayOrTimed; }

#ifdef SYMBIAN_SYSTEM_STATE_MANAGEMENT

	IMPORT_C void SetWakeup(TBool aEnabled);

	IMPORT_C TBool IsWakeup() const;

#endif

#ifdef SYMBIAN_ALARM_REPEAT_EXTENSIONS

#endif

public:										

    // CLient Data Access 

    /**

     * Returns a writable version of the alarm's client flags.

     * 

     * The client flags may be used for any client-specific data - the alarm server does not use them.

     * 

     * @return Reference to the alarm's bit flags.

     */

	inline TBitFlags16& ClientFlags() { return iClientFlags; }

    /**

     * Returns this alarm's client flags.

     * 

     * @return Reference to the alarm's bit flags.

     */

	inline TBitFlags16 ClientFlags() const { return iClientFlags; }

    /**

     * Returns the client data from slot 1 for this alarm.

     * 

     * @return The first client-specific integer.

     */

	inline TInt	ClientData1() const { return iClientData1; }

    /**

     * Returns a writable version of the client data from slot 1 for this alarm.

     * 

     * @return Reference to the first client-specific integer.

     */

	inline TInt& ClientData1() { return iClientData1; }

    /**

     * Returns the client data from slot 2 for this alarm.

     * 

     * @return The second client-specific integer.

     */

	inline TInt ClientData2() const { return iClientData2; }

    /**

     * Returns the client data from slot 2 for this alarm.

     * 

     * @return The second client-specific integer.

     */

	inline TInt& ClientData2() { return iClientData2; }

    /**

     * Tests whether the alarm is floating.

     * 

     * Floating alarms expire at a given wall-clock time regardless of the 

     * current locale and whether any daylight saving time rules are in force.

     * 

     * @return True if the alarm is floating.

     */

	inline TBool IsFloating() const { return iCharacteristics.IsClear(EAlarmCharacteristicsIsFixed); }

protected:									

    // Internal Flags

#ifndef SYMBIAN_ENABLE_SPLIT_HEADERS

		/**

		 * @publishedAll

		/**

		 * @publishedAll

		/**

		 * @publishedAll

		/**

		 * Set if alarm is disabled manually so that can not be enabled when locale changes.

		 * 

		 * @publishedAll 

#endif

#ifndef SYMBIAN_ENABLE_SPLIT_HEADERS

#ifdef SYMBIAN_SYSTEM_STATE_MANAGEMENT

		EASShdAlarmFlag2Wakeup = 0,

#endif

#ifdef SYMBIAN_ALARM_REPEAT_EXTENSIONS

    /*

	 * @internalComponent

	 */

#endif

#endif //SYMBIAN_ENABLE_SPLIT_HEADERS

protected:									

    /**

	/**

	/**