1 /*

     2 * Copyright (c) 2008-2009 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:    wrapper for Back Stepping Service

    15 *

    16 */

    17 

    18 

    19 

    20 

    21 #ifndef C_GLX_BACKSERVICE_WRAPPER

    22 #define C_GLX_BACKSERVICE_WRAPPER

    23 

    24 #include <e32base.h>

    25 

    26 class MLiwInterface;

    27 class CLiwGenericParamList;

    28 class CLiwServiceHandler;

    29 

    30 /**

    31  *   BS Service wrapper

    32  *

    33  *  @since S60 v3.2

    34  */

    35 class CGlxBackServiceWrapper : public CBase

    36     {

    37 

    38 public:

    39 

    40     /**

    41      * Two-phased constructors

    42      * @param aUid client application UID

    43      */

    44     static CGlxBackServiceWrapper* NewL( const TUid aUid );

    45     static CGlxBackServiceWrapper* NewLC( const TUid aUid );

    46     

    47     /**

    48     * Destructor.

    49     */

    50     virtual ~CGlxBackServiceWrapper();

    51 

    52     /**

    53      * Forwards activation event

    54      *

    55      * @since S60 v3.2

    56      * @param aState state of application like view ids

    57      * @param aEnter indicate if it is entry/exit activation

    58      * @return result code retutned by BS Service interface

    59      * @leave leaves from HandleResultL are propagated

    60      */

    61     IMPORT_C TInt ForwardActivationEventL( const TDesC8& aState, const TBool aEnter );

    62     

    63     /**

    64      * Handles back command

    65      *

    66      * @since S60 v3.2

    67      * @param aState state of application like view ids

    68      * @return result code retutned by BS Service interface

    69      * @leave leaves from HandleResultL are propagated

    70      */

    71     IMPORT_C TInt HandleBackCommandL( const TDesC8& aState, const TBool aCheckOnly = EFalse );

    72 

    73 private:

    74 

    75     CGlxBackServiceWrapper();

    76 

    77     /**

    78      * 2nd phase constructor

    79      * @param aUid client application UID

    80      */

    81     void ConstructL( const TUid aUid );

    82     

    83     /**

    84      * Initializes BS Service

    85      * @param aUid client application UID

    86      * @leave KErrNotSupported or KErrArgument 

    87      *        (if arguments passed to BS Service are incorrect 

    88      *        or could not initialize BS)

    89      *        KErrNotFound (if there was no return value)

    90      */

    91     void InitializeL( const TUid aUid );

    92     

    93     /**

    94      * Handles the result of a LIW command

    95      * @return result code retutned by BS Service interface

    96      * @leave KErrNotSupported or KErrArgument 

    97      *        (if arguments passed to BS Service are incorrect)

    98      *        KErrNotFound (if there was no return value)

    99      */

   100     TInt HandleResultL();

   101 

   102 private: // data

   103     

   104     /**

   105      * Liw Service Handler

   106      * Own.

   107      */

   108     CLiwServiceHandler* iServiceHandler;

   109     

   110     /**

   111      * BS Service interface returned by LIW

   112      * Own.

   113      */

   114     MLiwInterface* iBSInterface;

   115     

   116     /**

   117      * In param list

   118      * Not own.

   119      */

   120     CLiwGenericParamList* iInParamList;

   121     

   122     /**

   123      * Out param list

   124      * Not own.

   125      */

   126     CLiwGenericParamList* iOutParamList;

   127 

   128     };

   129 

   130 #endif // C_GLX_BACKSERVICE_WRAPPER