/*

* Copyright (c) 2008 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:  This class provides functionality for editing Events.

*

*/

#ifndef EVTEVENTSDLG_H

#define EVTEVENTSDLG_H

//  INCLUDES

#include <e32base.h>            // CBase

// User Includes

// FORWARD DECLARATIONS

class CEvtEvent;

class CEvtEditor;

class MObjectProvider;

class TCoeHelpContext;

class TCoordinate;

class CEvtMgmtUiEngine;

// CLASS DECLARATION

/**

*  This is a dialog class, which is used to launch Events editor dialog.

*/

class CEvtEventsDlg : public CBase

    {

    public:  // Constructors and destructor

        /**

        * This is a static function, which creates and returns an instance of this class.

        * The Event that has to be edited is shown in the editor.

    	*

        * @leave  Leaves with KErrNotSupported if framework functionality is not available.

        * @panic  Panics with system-wide panic codes.

        * @return new instance of this class

        */

        IMPORT_C static CEvtEventsDlg* NewL(TBool                              aIsEditable, 

                                            CEvtEvent&                         aEvent,                               

                                            CEvtMgmtUiEngine&                  aEventEngine,

                                            TBool                              aDisplayExitMenuItem = ETrue

                                            ); 

        /**

        * Destructor.

        */

        IMPORT_C ~CEvtEventsDlg();

    public: // New functions

        /**

        * This function sets the context - that is, the enclosing parent control - for this control.

        *

        * @param [in] aParent The parent object which is the context for the control.

        * @panic Panics with KLmkPanicNullMember, if the selector is not

        *        constructed properly.

        */

        IMPORT_C void SetMopParent( MObjectProvider* aParent );

        /**

        * This method sets help context. This provides an option to show the help context

        * of the application that launches editor. By default, we show the Events Ui help context.

        * @param[in] aContext help context to use

        */

        IMPORT_C void SetHelpContext( TCoeHelpContext aContext );

        /**

        * This function launches the Events editor dialog. Client uses this function

        * to launch events editor dialog.

        * This object is destroyed when this function returns or leaves.

        * @leave Leaves with system-wide leave codes.

        * @panic Panics with KEvtPanicNullMember, if the selector is not constructed properly.

        * @return Returns non-zero if accepted, else zero.

        */          

        IMPORT_C TInt ExecuteLD( );

    private:

        /**

        * C++ default constructor.

        * @return newly instantiated object

        */

        CEvtEventsDlg();

        /**

        * By default Symbian 2nd phase constructor is private.        

        */

        void ConstructL( TBool                              aIsEditable, 

                        CEvtEvent&                         aEvent,        

                        CEvtMgmtUiEngine&                  aEventEngine,

                        TBool                              aDisplayExitMenuItem = ETrue

                        );

    private:    // Data

        /// Own: Editor object

        CEvtEditor* iEvtEditor;  

        /// Own: A pointer to TBool

        TBool* iDestroyedPtr;

    };

#endif      // EVTEVENTSDLG_H   

// End of File