1 /*

     2 * Copyright (c) 2004 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:  UI controll context.

    15 *

    16 */

    17 

    18 #ifndef __MCNUIUICONTROLCONTEXT_H

    19 #define __MCNUIUICONTROLCONTEXT_H

    20 

    21 //  INCLUDES

    22 #include <E32Base.h>

    23 #include <impspresenceconnectionuiconstsng.h>

    24 #include "MCnUiBaseControlContext.h"

    25 

    26 

    27 

    28 //FORWARD DECLARATIONS

    29 class MCnUiUiFacade;

    30 class MCnUiConnProcessObserverProxy;

    31 class MCnUiConnModeRewaker;

    32 class CIMPSSAPSettings;

    33 class CPEngNWSessionSlotID2;

    34 

    35 

    36 

    37 /**

    38  * UI controll context.

    39  *

    40  * Extends base control context features by offering

    41  * full UI services.

    42  *

    43  * @since 2.1

    44  */

    45 NONSHARABLE_CLASS( MCnUiUiControlContext ) : public MCnUiBaseControlContext

    46     {

    47 public: // New static UI context access methods

    48 

    49 

    50     /**

    51      * Gets UI facade.

    52      *

    53      * @since 2.1

    54      * @return UI facade.

    55      */

    56     virtual MCnUiUiFacade& Ui() = 0;

    57 

    58 

    59     /**

    60      * Gets process observer proxy.

    61      *

    62      * @since 2.1

    63      * @return Process observer proxy.

    64      */

    65     virtual MCnUiConnProcessObserverProxy& ProcessObserverProxy() = 0;

    66 

    67 

    68     /**

    69      * Gets connection mode rewaker.

    70      *

    71      * @since 2.1

    72      * @return Connection mode rewaker.

    73      */

    74     virtual MCnUiConnModeRewaker& ConnModeRewaker() = 0;

    75 

    76 

    77 

    78 public: // New sub operation methods

    79 

    80     /**

    81      * Disconnects all currently connected clients.

    82      *

    83      * @since 2.1

    84      *

    85      * @param aDisconnectedSap On the return contains disconnected SAP details.

    86      * @param aDisconnectedClients On the return contains disconnected clients.

    87      * @return Error status from disconnect all operation.

    88      * KCnUiErrorNoClientsToDisconnect if there wasn't any client to disconnect.

    89      */

    90     virtual TInt SubOpDisconnectAllL( CIMPSSAPSettings& aDisconnectedSap,

    91                                       RArray< TIMPSConnectionClient >& aDisconnectedClients,

    92                                       const CPEngNWSessionSlotID2& aNWSessionSlotID ) = 0;

    93 

    94 

    95     /**

    96      * Reconnects all listed clients to given SAP.

    97      *

    98      * @since 2.1

    99      *

   100      * @param aReconnectedSap The SAP to reconnect.

   101      * @param aReconnectedClients The clients to reconnect.

   102      * @return Error status from reconnect all operation.

   103      */

   104     virtual TInt SubOpReconnectAllL( CIMPSSAPSettings& aReconnectedSap,

   105                                      CPEngNWSessionSlotID2& aNWSessionSlotID ) = 0;

   106 

   107 

   108 protected:  //Destructor

   109 

   110     /**

   111      * Inline destructor.

   112      *

   113      * Destruction using this

   114      * interface isn't possible.

   115      */

   116     ~MCnUiUiControlContext() {};

   117     };

   118 

   119 

   120 

   121 /**

   122  * Process observer proxy.

   123  * Controls access to process

   124  * observer.

   125  *

   126  * @since 2.1

   127  */

   128 NONSHARABLE_CLASS( MCnUiConnProcessObserverProxy )

   129     {

   130 public: //

   131 

   132     /**

   133      * Notifies possibly reqistered

   134      * process observer from SAP access.

   135      *

   136      * @since 2.1

   137      */

   138     virtual void NotifyAccessingSapL( const CIMPSSAPSettings& aAccessedSap ) = 0;

   139 

   140 

   141 

   142 protected:  //Destructor

   143 

   144     /**

   145      * Inline destructor.

   146      *

   147      * Destruction using this

   148      * interface isn't possible.

   149      */

   150     virtual ~MCnUiConnProcessObserverProxy() {};

   151     };

   152 

   153 

   154 

   155 #endif      //  __MCNUIUICONTROLCONTEXT_H

   156 

   157 //  End of File

   158