/*

* ============================================================================

*  Name        : bctestdomaiwserviceifmenu.h

*  Part of     : BCTest / bctestdomaiwakn       

*  Description : for testing CAiwServiceIfMenu and CAiwServiceIfBase

*  Version     : %version: 1 % << Don't touch! Updated by Synergy at check-out.

*

*  Copyright © 2007.  All rights reserved.

*  This material, including documentation and any related computer

*  programs, is protected by copyright controlled by Nokia.  All

*  rights are reserved.  Copying, including reproducing, storing,

*  adapting or translating, any or all of this material requires the

*  prior written consent of Nokia.  This material also contains

*  confidential information which may not be disclosed to others

*  without the prior written consent of Nokia.

* ============================================================================

* Template version: 4.2

*/

#ifndef C_CBCTESTDOMAIWSERVICEIFMENU_H

#define C_CBCTESTDOMAIWSERVICEIFMENU_H

#include <aiwserviceifmenu.h> 

/**

 *  test CAiwServiceIfMenu and CAiwServiceIfBase.

 *  

 *

 *  @code

 *    

 *  @endcode

 *

 *  @lib   

 *  @since S60 v5.0

 */ 

class CBCTestDomAiwServiceIfMenu : public CAiwServiceIfMenu

    {

public:

    IMPORT_C static CBCTestDomAiwServiceIfMenu* NewL();

    IMPORT_C static CBCTestDomAiwServiceIfMenu* NewLC();

    /**

     * Destructor.

     */

    IMPORT_C virtual ~CBCTestDomAiwServiceIfMenu();

    /**

     * test ExtensionInterface

     *  

     * @since S60 v5.0       

     */

    void TestFuncExtensionInterface() ;

// from base class CAiwServiceIfBase  

    /**

     * From CAiwServiceIfBase.      

     * Called by the AIW framework to initialise provider with necessary

     * information from the Service Handler. This method is called when 

     * the consumer makes the attach operation.

     *

     * @since S60 v5.0       

     * @param aFrameworkCallback Framework provided callback for provider 

     *                  to send events to framework.

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

     */

     virtual void InitialiseL(

         MAiwNotifyCallback& aFrameworkCallback,

         const RCriteriaArray& aInterest) ;

    /**

     * From CAiwServiceIfBase.      

     * Executes generic service commands included in criteria.

     *

     * @since S60 v5.0       

     * @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* in 

     *        AiwCommon.hrh.

     * @param aCallback Callback for asynchronous command handling, 

     *        parameter checking, etc.

     * @leave KErrArgument Callback is missing when required.

     * @leave KErrNotSupported No provider supports service.

     */

     virtual void HandleServiceCmdL(

         const TInt& aCmdId,

         const CAiwGenericParamList& aInParamList,

         CAiwGenericParamList& aOutParamList,

         TUint aCmdOptions = 0,

         const MAiwNotifyCallback* aCallback = NULL) ;

// from base class CAiwServiceIfMenu    

    /**

     * From CAiwServiceIfMenu.    

     * Provider should implement this method to initialise a menu pane by 

     * adding provider specific menu items. The AIW framework gives the 

     * parameters to beused in the addition process.

     *

     * @since S60 v5.0     

     * @param aMenuPane Menu pane handle.

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

     * @param aCascadeId ID of cascade menu item.

     * @param aInParamList Input parameter list for provider's parameter

     *         checking.

     */

     virtual void InitializeMenuPaneL(

         CAiwMenuPane& aMenuPane,

         TInt aIndex,

         TInt aCascadeId,

         const CAiwGenericParamList& aInParamList);

    /**

     * From CAiwServiceIfMenu.    

     * Provider should implement this method to handle a menu command. 

     * Called by the Service Handler when a consumer calls ExecuteMenuCmdL().

     *

     * @since S60 v5.0     

     * @param aMenuCmdId Original provider specific ommand ID for the menu

     *              command.Defined in the provider's menu item resource.

     * @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 KAiwCmdOpt* in

     *         AiwCommon.hrh.

     * @param aCallback Callback if asynchronous command handling is wanted by

     *             consumer.The provider may or may not support this. A 

     *             provider should leave with KErrNotSupported, if not.

     * @leave KErrNotSupported Callback is not supported.

     */

     virtual void HandleMenuCmdL(

         TInt aMenuCmdId,

         const CAiwGenericParamList& aInParamList,

         CAiwGenericParamList& aOutParamList,

         TUint aCmdOptions = 0,

         const MAiwNotifyCallback* aCallback = NULL); 

private:

    CBCTestDomAiwServiceIfMenu();

    void ConstructL();

    };

#endif // C_CBCTESTDOMAIWSERVICEIFMENU_H