--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/meetingrequest/mrgui/inc/mesmrfieldvalidator.h	Thu Dec 17 08:39:21 2009 +0200
@@ -0,0 +1,239 @@
+/*
+* Copyright (c) 2007 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:  ESMR interface for time/date validation implemenatation
+ *
+*/
+
+
+#ifndef MESMRFIELDVALIDATOR_H
+#define MESMRFIELDVALIDATOR_H
+
+//<cmail>
+#include "esmrdef.h"
+//</cmail>
+
+class MESMRCalEntry;
+class CEikTimeEditor;
+class CEikDateEditor;
+class MESMRFieldEventQueue;
+
+/**
+ * MESMRFieldValidator defines interface for field validation.
+ * Validators check input values and adjust field values to
+ * correctly.
+ *
+ * MESMRFieldValidator is base class for all concrete validators.
+ */
+class MESMRFieldValidator
+    {
+public:
+
+    /**
+     * Enumeration for validator error types
+     */
+    enum TESMRFieldValidatorError
+        {
+        /** No validation errors */
+        EErrorNone = 0,
+        /** Entry ends earlier than starts */
+        EErrorEndEarlierThanStart,
+        /** Entry is recurrent and has differend start and end dates */
+        EErrorRecDifferetStartAndEnd,
+        /** Recurrence until is earlier than first instance start time */
+        EErrorRecUntilEarlierThanStart,
+        /** Alarm is later that entry starts */
+        EErrorAlarmLaterThanStart,
+        /** Alarm occurs in past */
+        EErrorAlarmInPast,
+        /** Alarm occurs too much in past*/
+        EErrorAlarmTooMuchInPast,
+        /** Relative alarm occurs in past */
+        EErrorRelativeAlarmInPast,
+        /** Reschedule instance to same day with another instance */
+        EErrorRescheduleInstance
+        };
+
+public:
+    /**
+     * Virtual destructor.
+     */
+    virtual ~MESMRFieldValidator( ) { }
+
+    /**
+     * Validate entered values. Returns validation eror code.
+     * Parameter aCorrectAutomatically defines, if validator
+     * adjusts field so that no validation errors occur.
+     *
+     * @param aCorrectAutomatically If ETrue, fields are adjusted
+     *                              automatically.
+     * @return Validation error code.
+     */
+    virtual TESMRFieldValidatorError ValidateL(
+            TBool aCorrectAutomatically ) = 0;
+
+    /**
+     * Read values to entry and stores them to fields.
+     * @param aEntry Reference to entry.
+     */
+    virtual void ReadValuesFromEntryL(
+            MESMRCalEntry& aEntry ) = 0;
+
+    /**
+     * Store values to entry.
+     * @param aEntry Reference to entry.
+     */
+    virtual void StoreValuesToEntryL(
+            MESMRCalEntry& aEntry ) = 0;
+
+    /**
+     * Sets start time field.
+     * @param aStartTime Reference to start time field.
+     */
+    virtual void SetStartTimeFieldL(
+            CEikTimeEditor& aStartTime ) = 0;
+
+    /**
+     * Sets end time field.
+     * @param aEndTime Reference to end time field.
+     */
+    virtual void SetEndTimeFieldL(
+            CEikTimeEditor& aEndTime ) = 0;
+
+    /**
+     * Sets start time field.
+     * @param aStartDate Reference to start date field.
+     */
+    virtual void SetStartDateFieldL(
+            CEikDateEditor& aStartDate ) = 0;
+
+    /**
+     * Sets end time field.
+     * @param aEndDate Reference to end date field.
+     */
+    virtual void SetEndDateFieldL(
+            CEikDateEditor& aEndDate ) = 0;
+
+    /**
+     * Sets alarm time field.
+     * @param aAlarmTime Reference to alarm time field.
+     */
+    virtual void SetAlarmTimeFieldL(
+            CEikTimeEditor& aAlarmTime ) = 0;
+
+    /**
+     * Sets alarm date field.
+     * @param aAlarmDate Reference to alarm date field.
+     */
+    virtual void SetAlarmDateFieldL(
+            CEikDateEditor& aAlarmDate ) = 0;
+
+    /**
+     * Sets alarm date field.
+     * @param aAlarmDate Reference to alarm date field.
+     */
+    virtual void SetRecurrenceUntilDateFieldL(
+            CEikDateEditor& aRecurrenceUntil ) = 0;
+
+    /**
+     * Triggers start time change.
+     */
+    virtual void StartTimeChangedL() = 0;
+
+    /**
+     * Triggers end time change.
+     */
+    virtual void EndTimeChangedL() = 0;
+
+    /**
+     * Triggers start date change.
+     */
+    virtual void StartDateChandedL() = 0;
+
+    /**
+     * Triggers end date change.
+     */
+    virtual void EndDateChangedL() = 0;
+
+    /**
+     * Triggers alarm time change.
+     */
+    virtual void AlarmTimeChangedL() = 0;
+
+    /**
+     * Triggers alarm date change.
+     */
+    virtual void AlarmDateChangedL() = 0;
+
+    /**
+     * Triggers relative alarm change.
+     * When values are forced in meeting validator, alarmfields
+     * Externalize method needs to know if relative alarm is valid.
+     * If aRelativeAlarmValid != ETrue, then alarm is considered
+     * to be unvalid, and is set off (in CESMRAlarmField::ExternalizeL)
+     *
+     * @param aCurrentAlarmTimeOffset current alarm time offset
+     * @param aRelativeAlarmValid for alarm validity check
+     */
+    virtual void RelativeAlarmChangedL(
+            TTimeIntervalMinutes aCurrentAlarmTimeOffset,
+            TBool aHandleAlarmChange,
+            TBool& aRelativeAlarmValid ) = 0;
+
+    /**
+     * Set 'all day' flag for validator.
+     */
+    virtual void SetAllDayEventL(
+            TBool aAlldayEvent ) = 0;
+
+    /**
+     * Set 'alarm' flag for validator.
+     * @param aAlarmOn Alarm on/off
+     */
+    virtual void SetAlarmOnOffL(
+            TBool aAlarmOn ) = 0;
+
+    /**
+     * Triggers recurrence change.
+     * @param aRecurrence new recurrence value
+     */
+    virtual void RecurrenceChangedL(
+            TESMRRecurrenceValue aRecurrence ) = 0;
+
+    /**
+     * Triggers end date change.
+     */
+    virtual void RecurrenceEndDateChangedL() = 0;
+
+    /**
+     * Checks if relative alarm is valid
+     * @param aAlarmTimeOffset Alarm time offset
+     */
+    virtual TBool IsRelativeAlarmValid(
+            TTimeIntervalMinutes aAlarmTimeOffset ) = 0;
+
+    /**
+     * Sets field event queue for validator.
+     * Validator can send field events to event observers using the
+     * event queue.
+     * 
+     * @param aEventQueue the event queue.
+     */
+    virtual void SetFieldEventQueue( MESMRFieldEventQueue* /*aEventQueue*/ ) {}
+    };
+
+#endif  // MESMRFIELDVALIDATOR_H
+
+// EOF
+
+