/*

* Copyright (c) 2002 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:  source file.

*                Write all source code here, all the implementations

*

*/

#include <eikmenup.h>

#include "AiwHelpProvider.h"

#include <AiwMenu.h>

#include <barsread.h>

#include <eikenv.h>

#include <AiwHelpProviderPlugin.rsg>

#include <ImplementationProxy.h>

#include "AiwHelpProvider.rh"

#include <AiwServiceIfMenu.h>

#include <AiwCommon.h>

#include <hlplch.h>

#include <coemain.h>

#include <avkon.hrh>

_LIT(KResFileName, "\\resource\\apps\\AiwHelpProviderPlugin.rsc");

#define KImplementationId 0x10207465

/******************************************************************

===================================================================

						NewL of the Provider

===================================================================

*******************************************************************/						

CAiwHelpProvider* CAiwHelpProvider::NewL()

    {

    return new (ELeave) CAiwHelpProvider();

    }

/******************************************************************

===================================================================

						Constructor of the Provider

===================================================================

*******************************************************************/

CAiwHelpProvider::CAiwHelpProvider()

    {

    }

/******************************************************************

===================================================================

					Destructor of the Provider

===================================================================

*******************************************************************/

CAiwHelpProvider::~CAiwHelpProvider()

    {

    }

/**

        * Called by the Handler framework to initialise provider with

        * necessary information from Handler.

        * @param aFrameworkCallback Framework provided callback for

        *        provider to send events to framework

        * @param aInterest List of criteria items which invoked the provider.

        * @exception Symbian OS error code

        */

void CAiwHelpProvider::InitialiseL(MAiwNotifyCallback& /*aFrameworkCallback*/,

    const RCriteriaArray& /*aInterest*/)

    {

    }

/**

        * Executes generic service commands included in criteria.

        * @param aCmdId Command to be executed

        * @param aInParamList Input parameters, can be an empty list

        * @param aOutParamList Output parameters, can be an empty list

        * @param aCmdOptions Options for the command, see KAiwOpt* constants in AiwCommon.hrh.

        * @param aCallback callback for asynchronous command handling, parameter checking, etc.

        * @see enum TAiwServiceCmdOptions in AiwCommon.hrh

        * @exception KErrArgument if callback is missing when required.

        * @exception KErrNotSupported if no provider support service

        */

void CAiwHelpProvider::HandleServiceCmdL(const TInt& /*aCmdId*/,

    const CAiwGenericParamList& /*aInParamList*/,

    CAiwGenericParamList& /*aOutParamList*/,

    TUint aCmdOptions,

    const MAiwNotifyCallback* /*aCallback*/)

    {

 	// Cancel bit must always be checked. 

    if(aCmdOptions & KAiwOptCancel)

        {

        return;

        }

    }

/**

        * Initialises menu pane by adding provider specific menu items.

        * The AIW Framework gives the parameters to be used in addition.

        * @param aMenuPane Menu pane handle

        * @param aIndex position of item where to add menu items.

        * @param aCascadeId ID of cascade menu item.

        * @param aInParamList input parameter list for provider's parameters checking

        */

void CAiwHelpProvider::InitializeMenuPaneL(CAiwMenuPane& aMenuPane,

    TInt aIndex,

    TInt /*aCascadeId*/,

    const CAiwGenericParamList& /*aInParamList*/)

    {

    TFileName resFile(KResFileName);

    TFileName dllName;

    Dll::FileName(dllName);

    TBuf<2> drive = dllName.Left(2);

    resFile.Insert(0, drive);

    aMenuPane.AddMenuItemsL(resFile, R_AIWHELPPROVIDER_MENU, KAiwCmdHelp, aIndex);

    }

/**

        * Handle a menu command invoked by the Handler.

        * @param aMenuCmdId Command ID for the menu command,

        *        defined by the provider when adding the menu commands.

        * @param aInParamList Input parameters, could be empty list

        * @param aOutParamList Output parameters, could be empty list

        * @param aCmdOptions Options for the command, see KAiwCmdOpt* constants.

        * @param aCallback callback if asynchronous command handling is wanted by consumer.

        *    The provider may or may not support this, leaves with KErrNotSupported, it not.

        */

void CAiwHelpProvider::HandleMenuCmdL(TInt aMenuCmdId,

    const CAiwGenericParamList& aInParamList,

    CAiwGenericParamList& /*aOutParamList*/,

    TUint aCmdOptions,

    const MAiwNotifyCallback* /*aCallback*/)

    {

    // Cancel bit must always be checked.

    if(aCmdOptions & KAiwOptCancel)

        {

        return;

        }

    switch (aMenuCmdId)

	    {

	    case EAiwShowHelpCmd:

	    case EAknCmdHelp:

		    {

		    TCoeHelpContext helpContext;

		    TInt index;

		    // Get the UID of the Help context i.e. the UID of the CS Help file containing 

		    // the topic information.

		    index = 0;

		    const TAiwGenericParam* uidParam = aInParamList.FindFirst(index, EGenericParamHelpItem, 

		        EVariantTypeTUid);

		    if(index >= 0)

		        {

		        // Get the data.

		        const TAiwVariant& val = uidParam->Value();

		        helpContext.iMajor = val.AsTUid();

		        }

		    else

		        {

		        // UID param not found. Error handling could be added here.

		        }            

		    // Get the context of Help i.e. the name of the help context. This is the literal 

		    // descriptor generated from a context string by the CSHelp compiler.          

		    index = 0;

		    const TAiwGenericParam* contextParam = aInParamList.FindFirst(index, EGenericParamHelpItem, 

		        EVariantTypeDesC);

		    if(index >= 0)

		        {

		        // Get the data.

		        const TAiwVariant& val = contextParam->Value();

		        helpContext.iContext = val.AsDes();

		        }

		    else

		        {

		        // Context param not found. Error handling could be added here.

		        }             

		    CArrayFix<TCoeHelpContext>* contextList = new (ELeave) CArrayFixFlat<TCoeHelpContext>(1);

		    contextList->AppendL(helpContext);

		    //Get the Window server session

		    RWsSession wsSession;

		    User::LeaveIfError(wsSession.Connect());

		    CleanupClosePushL(wsSession);

		    HlpLauncher::LaunchHelpApplicationL(wsSession,contextList);

		    CleanupStack::PopAndDestroy();

		    break;

		    }

        default:

            break;

        }

    }

//

// Rest of the file is for ECom initialization. 

//

// Map the interface UIDs to implementation factory functions

const TImplementationProxy ImplementationTable[] =

    {

        IMPLEMENTATION_PROXY_ENTRY(KImplementationId, CAiwHelpProvider::NewL)

    };

// ---------------------------------------------------------

// Exported proxy for instantiation method resolution

// ---------------------------------------------------------

//

EXPORT_C const TImplementationProxy* ImplementationGroupProxy(TInt& aTableCount)

    {

    aTableCount = sizeof(ImplementationTable) / sizeof(TImplementationProxy);

    return ImplementationTable;

    }