/*

* 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 Alarm field implementation

 *

*/

#ifndef CESMRALARMFIELD_H

#define CESMRALARMFIELD_H

#include "cesmriconfield.h"

class CEikLabel;

class CESMRAlarm;

class MESMRFieldValidator;

/**

 * Alarm field defines the time before the meeting when

 * alarm should be showed. User can traverse between the

 * different alarm values by pressing left/right keys or

 * open a dialog by pressing ok button.

 *

 * @see cesmralarm.h

 */

NONSHARABLE_CLASS( CESMRAlarmField ) : public CESMRIconField

    {

public:

    /**

     * Two phase constructor.

     */

    static CESMRAlarmField* NewL( MESMRFieldValidator* aValidator );

    /**

     * Destructor.

     */

    ~CESMRAlarmField();

public: // From CESMRField

    void InitializeL();

    void InternalizeL( MESMRCalEntry& aEntry );

    void ExternalizeL( MESMRCalEntry& aEntry );

    void SetOutlineFocusL( TBool aFocus );

    TBool OkToLoseFocusL( TESMREntryFieldId aId );

    void ExecuteGenericCommandL( TInt aCommand );

public: // From CCoeControl

    TKeyResponse OfferKeyEventL(const TKeyEvent& aEvent, TEventCode aType);

private:

    /**

     * Constructor

     */

    CESMRAlarmField( MESMRFieldValidator* aValidator );

    /**

     * Second phase constructor

     */

    void ConstructL();

    /**

     * Updates new alarm time

     *

     * @param aIndex new alarm time index

     */

    void UpdateAlarmLabelL( TInt aIndex );

    /**

     * Updates alarm to first valid value, when

     * alarm has been set to past by user

     */

    void UpdateAlarmToFirstValidValueL();

    /**

     * Handles alarm time settings query

     */

    void DoAlarmTimeQueryL();

    /**

     * Triggers validator to validate alarm

     */

    TBool TriggerValidatorL();

    /**

      * Handles MSK command execution

      */

    void ExecuteMSKCommandL();

private:

    /**

     *  Not own: Label for current alarm value

     */

    CEikLabel* iAlarm;

    /**

     * Own: List of CESMRAlarm objects

     */

    RPointerArray< CESMRAlarm > iArray;

    /**

     * Index pointing to iArray.

     */

    TInt iOptIndex;

    /**

     * Not owned. Validator class for time and sanity checks.

     */

    MESMRFieldValidator* iValidator;

    /**

     * Own: Relative alarm validity

     */

    TBool iRelativeAlarmValid;

    };

#endif  //CESMRALARMFIELD_H