/*

* 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:   Description component for retrieving description.

*

*/

#ifndef EVTMGMTUIDESCCOMPONENT_H_

#define EVTMGMTUIDESCCOMPONENT_H_

#include <e32base.h>        // CBase

// Forward Declaration

class CNotepadApi;

/**

 *  @class CEvtMgmtUiDescComponent

 *  Class that represents Description component of editor

 *

 *  This class acts as description component of editor.

 *  It  is used to retrieve description from notepad.

 *  It is also used to create new description using notepad.

 *  Note: Created description is not stored in Notepad application.

 *

 *  @since S60 v9.1

 */

class CEvtMgmtUiDescComponent: public CBase

    {

private:

    public:  // Constructor and destructor  

        /**

         * Static Two phase constructor

         * @param [in] aPrevDesc - description of existing event.

         *                       - empty for newly created event        

         */

        static CEvtMgmtUiDescComponent* NewL(const TPtrC aPrevDesc);

      /**

       * Static Two phase constructor

       * @param [in] aPrevDesc - description of existing event.

       *                       - empty for newly created event        

       */

      static CEvtMgmtUiDescComponent* NewLC(const TPtrC aPrevDesc);

      /**

       * Virtual destructor

       */

      virtual ~CEvtMgmtUiDescComponent(); 

    public:// new functions

      /**

       * It displays notepad editor and saves in descriptor variable

       * 

       * @since S60 v9.1

       * 

       * @return KErrCancel if deleted

       *         KErrAlreadyExists if not modified

       *         KErrNone if modified

       */

        TInt DisplayNotepadEditorL(); 

       /**

       * It opens system's memo popup dialog and 

       * saves selected memo as descriptor.

       * 

       * @since S60 v9.1

       *  

       * @return KErrCancel if cancel or no note

       *         KErrNone if note is selected

       */

        TInt DescFromExistingNotesL();

        /**

        * It retrieves descriptor

        * 

        * @since S60 v9.1

        * 

        * @return selected descriptor

        */

         TPtrC Desc() const;        

    private:  // Constructor

        /**

         * C++ Default constructor

         */       

        CEvtMgmtUiDescComponent();

        /**

         * Second phase of the two phase constructor

         *  @param [in] aPrevDesc - description of existing event.

         *                        - empty for newly created event        

         */ 

         void ConstructL( const TPtrC aPrevDesc );

    private:

        /**

         * description value

         * owns

         */

        HBufC* iDesc;

        /**

         * Notepad Instance

         * owns

         */

        CNotepadApi* iNotepad;

    };

#endif //EVTMGMTUIDESCCOMPONENT_H_