diff -r 1fc85118c3ae -r 870918037e16 eventsui/eventshandlerui/eventshandlerapp/inc/evtdlglauncher.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/eventsui/eventshandlerui/eventshandlerapp/inc/evtdlglauncher.h Wed Sep 01 12:31:27 2010 +0100 @@ -0,0 +1,155 @@ +/* +* 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: Events Dialog Launcher. +* +*/ + + +#ifndef C_EVTDLGLAUNCHER_H +#define C_EVTDLGLAUNCHER_H + +// System Includes +#include + +#include "evtmgmtuiengine.h" +#include "evtdefs.h" + +// Forward Declarations +class CEvtEventsDlg; +class CEvtRequest; + +/** + * Events Dialog Exit Handler. + * + * @since v5.0 + */ +class MEvtDlgObserver + { +public: + /** + * It will be used to notify observer that event editor is + * dismissed + */ + virtual void NotifyDlgDismissedL() = 0; + }; + +/** + * Interface class to Handle the Event's Dialog launching Request. + * This class allows for + * 1. launching of an event viewer dialog. + * 2. launching of Notepad Editor for Viewing description. + * 3. Cancelling of any outstanding Dialogs + * + * @lib + * @since S60 v9.1 + */ +class CEvtDlgLauncher : public CActive, + public MEvtMgmtUiEngineObserver +{ +public: + /** + * Constructs a new instance of Dialog Launcher. + * + * @return The new instance of Dialog Launcher object. + * @leave System wide error code if the object creation fails. + */ + IMPORT_C static CEvtDlgLauncher* NewL( CEvtMgmtUiEngine& aEngine, MEvtDlgObserver& aObserver ); + + /** + * Constructs a new instance of Dialog Launcher. + * Leaves the created instance on the cleanup stack. + * + * @return The new instance of Dialog Launcher object. + * @leave System wide error code if the object creation fails. + */ + IMPORT_C static CEvtDlgLauncher* NewLC( CEvtMgmtUiEngine& aEngine, MEvtDlgObserver& aObserver ); + + /** + * Destructor. + */ + virtual ~CEvtDlgLauncher(); + +public: // Public Functions + /** + * Launch the dialog for the given Event Request. + * + * @since S60 v9.1 + * @param[in] aRequest Event Request + * @leave System wide Leave error code. + */ + void LaunchDlgL( CEvtRequest& aRequest ); + + /** + * Cancel the currently open dialog. + * + * @since S60 v9.1 + * @leave System wide Leave error code. + */ + void CancelDlgL( TBool aIsForcedCancel ); + + /** + * Inherited from MEvtMgmtUiEngineObserver + */ + void NotifyEventChangeL(TInt aErrorCode, TInt aState ); + + /** + * Inherited from MEvtMgmtUiEngineObserver + */ + void NotifyModelChangeL(); + +private: // Inherited from CActive + virtual void RunL(); + + virtual void DoCancel(); + + virtual TInt RunError( TInt aError ); + +private: + + /** + * Default C++ Constructor. + */ + CEvtDlgLauncher( CEvtMgmtUiEngine& aEngine, MEvtDlgObserver& aObserver ); + + /** + * Second phase of the two phase constructor. + */ + void ConstructL(); + +private: // data + + /** + * Observer for Dialog Exit + */ + MEvtDlgObserver& iObserver; + + /** + * Events Engine + */ + CEvtMgmtUiEngine& iEngine; + + /** + * Event for which the Dialog has to be launched + * Not owned + */ + CEvtRequest* iRequest; + + /** + * Dialog Launcher for Editing the Events. + */ + CEvtEventsDlg* iDialog; + +}; + +#endif C_EVTDLGLAUNCHER_H \ No newline at end of file