/*

* 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:   Wrapper implementation class for launching S60 Calendar

*

*/

#ifndef CALENLAUNCHERIMPL_H

#define CALENLAUNCHERIMPL_H

/**

* Include files

*/

#include <calentry.h>   // CCalEntry::TType

/**

* Class Declaration.

* CCalenLauncherImpl is the implementation of CalenLauncher

*/

NONSHARABLE_CLASS( CCalenLauncherImpl ) : public CBase

    {

    public:

        /**

         * First stage constructor

         * Creates an instance of CCalenLauncherImpl and places it

         * on the cleanup stack before passing ownership to the caller.

         */

    	/**

         * Class destructor

         * Frees all resources used by this class

         */

    	~CCalenLauncherImpl();

        /**

         * Opens Calendar directly to the new entry editor.

         * Calendar will be closed when the editor is closed.

         * Any open dialogs (eg entry viewer or editor) will be closed.

         * @param aEntryType Type of entry editor to open

         */

        void NewEntryL( const CCalEntry::TType& aEntryType, TInt aFlag = 0 );

        /**

         * Opens a Calendar entry directly in the entry viewer.  If the

         * entry is a repeating entry then entire series will be opened.

         * The entry editor may be launched from the entry viewer.

         * Calendar will be closed when the viewer is closed.

         * Any open dialogs (eg entry viewer or editor) will be closed.

         * @param aLocalUid LocalUid of the entry to view

         */

        void ViewEntryL( const TCalLocalUid& aLocalUid );

        /**

         * Opens an instance of a repeating Calendar entry directly in the

         * entry viewer.

         * The entry editor may be launched from the entry viewer.

         * Calendar will be closed when the viewer is closed.

         * Any open dialogs (eg entry viewer or editor) will be closed.

         * @param aLocalUid LocalUid of the entry to view

         * @param aInstanceTime Instance time of the repeated entry

         */

        void ViewEntryL( const TCalLocalUid& aLocalUid, const TCalTime& aInstanceTime, TInt aFlags );

        /**

         * Opens an instance of a repeating Calendar entry directly in the

         * entry viewer.

         * The entry editor may be launched from the entry viewer.

         * Calendar will be closed when the viewer is closed.

         * Any open dialogs (eg entry viewer or editor) will be closed.

         * @param aLocalUid LocalUid of the entry to view

         * @param aCalFileName Calendar DB name of the repeated entry

         * @param aInstanceTime Instance time of the repeated entry

         */

        void ViewEntryL( const TCalLocalUid& aLocalUid, const TCalTime& aInstanceTime, const TDesC& aCalFileName, TInt aFlags );

        /**

         * Opens a Calendar entry directly in the entry editor.  If the

         * entry is a repeating entry then entire series will be opened.

         * Calendar will be closed when the editor is closed.

         * Any open dialogs (eg entry viewer or editor) will be closed.

         * @param aLocalUid LocalUid of the entry to view

         */

        void EditEntryL( const TCalLocalUid& aLocalUid );

        /**

         * Opens an instance of a repeating Calendar entry directly in the

         * entry editor.

         * Calendar will be closed when the editor is closed.

         * Any open dialogs (eg entry viewer or editor) will be closed.

         * @param aLocalUid LocalUid of the entry to view

         * @param aInstanceTime Instance time of the repeated entry

         */

        void EditEntryL( const TCalLocalUid& aLocalUid, const TCalTime& aInstanceTime );

        /**

         * Launches Calendar in the specified view.

         * If Calendar is already running it will be brought to the foreground

         * in the specified view.

         * Any open dialogs (eg entry viewer or editor) will be closed.

         * @param aViewUid UID of the Calendar view to use.

         */

        void LaunchL( const TUid& aViewUid );

        /**

         * Launches Calendar in the specified view, focused to the specified time

         * If Calendar is already running it will be brought to the foreground

         * in the specified view.

         * Any open dialogs (eg entry viewer or editor) will be closed.

         * @param aViewUid UID of the Calendar view to use.

		 * @param aInstanceTime Initial focus time

         */

        void LaunchL( const TUid& aViewUid, const TCalTime& aInstanceTime );

	private:

		/**

		 * Private constructor

		 */

		CCalenLauncherImpl();

		/**

		 * Second stage constructor

		 * Performs any leaving operations needed for construction.

		 */

		void ConstructL();

        /**

        * AddLaunchParamL

        * Adds a parameter to the unicode launch string

        * @param aLaunchParam Parameter to add

        */

        void AddLaunchParamL( const TDesC& aLaunchParam );

        /**

        * AddTimeParamL

        * Expands a TCalTime and adds the individual components to the

        * unicode launch string.

        * @param aCalTime Time to add.

        */

        void AddTimeParamL( const TCalTime& aCalTime );

        /**

        * AddUidParamL

        * Adds a local uid to the unicode launch string.

        * @param aLocalUid Uid to add.

        */

        void AddUidParamL( const TCalLocalUid& aLocalUid );

        /**

        * AddViewUidParamL

        * Adds a view uid to the unicode launch string as a command.

        * @param aViewUid Uid to add.

        */

        void AddViewUidParamL( const TUid& aViewUid );

        /**

        * ConvertLaunchParamsFromUnicodeL

        * Sets the launch parameters to be passed through to Calendar

        */

        void ConvertLaunchParamsFromUnicodeL();

        /**

        * LaunchAppL

        * Starts Calendar with command line parameters.  This will call

        * TApaTask::SendMessage if Calendar is running, or launch Calendar normally.

        * Either way, the command line parameters will end up in

        * CCalenAppUi::ProcessCommandParametersL

        */

        void LaunchAppL();

        /**

        * AddFlagParamL

        * Adds a parameter to the unicode launch string

        * @param aFlag Parameter to add

        */

        void AddFlagParamL( TInt aFlag );

    private:

        HBufC* iLaunchUnicode;

        HBufC8* iLaunchParams;

    };

#endif // __CALENLAUNCHERIMPL_H__

// End of File