1 /*

     2 * Copyright (c) 2005-2007 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Header file for the UpnpAiwMoveToExternalService.

    15 *

    16 */

    17 

    18 

    19 #ifndef _UPNP_AIW_MOVE_TO_EXTERNAL_SERVICE_H

    20 #define _UPNP_AIW_MOVE_TO_EXTERNAL_SERVICE_H

    21 

    22 //  INCLUDES

    23 #include <AiwServiceIfMenu.h>

    24 #include "upnpaiwengineobserver.h"

    25 

    26 // FUNCTION PROTOTYPES

    27 class CUPnPAiwEngine;

    28 class CUpnpDrmFilter;

    29 

    30 // CLASS DECLARATION

    31 

    32 /**

    33 *  CUPnPAiwMoveToExternalService

    34 *  The class implements the "Move to external" service of the

    35 *  UPnP AIW Media Provider.

    36 *  @since Series S60 3.0

    37 */

    38 class CUPnPAiwMoveToExternalService : public CAiwServiceIfMenu,

    39                                       public MUPnPAiwEngineObserver

    40     {

    41 

    42     public: // Constructors and destructor

    43 

    44         // Two-phased constructor.

    45         static CUPnPAiwMoveToExternalService* NewL();

    46 

    47         // Destructor.

    48         virtual ~CUPnPAiwMoveToExternalService();

    49 

    50     public: // Methods from the CAiwServiceIfMenu

    51 

    52         // Unnecessary methods

    53         void InitialiseL(   MAiwNotifyCallback& /*aFrameworkCallback*/,

    54                             const RCriteriaArray& /*aInterest*/ ) {}

    55         void HandleServiceCmdL(

    56                             const TInt& /*aCmdId*/,

    57                             const CAiwGenericParamList& /*aInParamList*/,

    58                             CAiwGenericParamList& /*aOutParamList*/,

    59                             TUint /*aCmdOptions*/,

    60                             const MAiwNotifyCallback* /*aCallback*/) {}

    61 

    62         /**

    63         * Initialises menu pane by adding provider specific menu items.

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

    65         * @param aMenuPane Menu pane handle

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

    67         * @param aCascadeId ID of cascade menu item.

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

    69         *        checking

    70         */

    71         void InitializeMenuPaneL( CAiwMenuPane& aMenuPane,

    72                                   TInt aIndex,

    73                                   TInt aCascadeId,

    74                                   const CAiwGenericParamList& aInParamList);

    75 

    76         /**

    77         * Handle a menu command invoked by the Handler.

    78         * @param aMenuCmdId Command ID for the menu command,

    79         *        defined by the provider when adding the menu commands.

    80         * @param aInParamList Input parameters, could be empty list

    81         * @param aOutParamList Output parameters, could be empty list

    82         * @param aCmdOptions Options for the command, see KAiwCmdOpt* 

    83         *        constants.

    84         * @param aCallback callback if asynchronous command handling is wanted

    85         *        by consumer. The provider may or may not support this, leaves

    86         *        with KErrNotSupported, it not.

    87         */

    88         void HandleMenuCmdL( TInt aMenuCmdId,

    89                              const CAiwGenericParamList& aInParamList,

    90                              CAiwGenericParamList& aOutParamList,

    91                              TUint aCmdOptions = 0,

    92                              const MAiwNotifyCallback* aCallback = NULL);

    93 

    94     public:  // MUPnPAiwEngineObserver

    95 

    96         // Unnecessary callback method

    97         void PlayCompleteL( TInt /*aStatus*/ ) {}

    98 

    99         /**

   100          * Indicates that the connection with the target UPnP

   101          * device has been lost.

   102          *

   103          * @since Series 60 3.0

   104          * @param None

   105          * @return None

   106          */

   107         void ConnectionLostL();

   108 

   109     private: // private methods

   110 

   111        /**

   112        * Deletes the contents of the iFileNames pointer array

   113        *

   114        * @since Series 60 3.0

   115        * @param None

   116        * @returns None

   117        */

   118        void EmptyFileNameArray();

   119 

   120 

   121     private: // construction

   122 

   123         // Constructor

   124         CUPnPAiwMoveToExternalService();

   125 

   126         // ConstructL

   127         void ConstructL();

   128 

   129     private: // Data members

   130 

   131         // reference to the engine component

   132         CUPnPAiwEngine* iEngine;            // not owned (singleton)

   133         

   134         // reference to the client (call back reference)

   135         MAiwNotifyCallback* iClient;        // not owned

   136 

   137         // The list of file names received as a parameter

   138         RPointerArray<TDesC16> iFileNames;  // owned

   139     };

   140 

   141 #endif // _UPNP_AIW_MOVE_TO_EXTERNAL_SERVICE_H

   142 

   143 // End of file