1 /*

     2 * Copyright (c) 2006 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:  Observer interface for supplementary services (SS) events.

    15 *

    16 */

    17 

    18 

    19 #ifndef MCCESSOBSERVER_H

    20 #define MCCESSOBSERVER_H

    21 

    22 /**

    23 * TODO list: 

    24 * Call waiting service status, should be available via phone settings UI.

    25 * DnD status

    26 * see ccp part

    27 */

    28 

    29 /**

    30  * Supplementary services observer.

    31  *

    32  * @since S60 v3.2

    33  */

    34 

    35 class MCCESsObserver

    36     {

    37 public:

    38 

    39     /** Barring related event. */

    40     enum TCCESsBarringEvent

    41         {

    42         /** Incoming call is barred. (DoCoMo) */

    43 		ECCESsIncomingCallBarred,	

    44 		/** Anonymous call barring. */

    45 		ECCESsAnonymousCallBarred,	

    46 		/** Outgoing call barring */

    47 		ECCESsOutgoingCallBarred,

    48 		/** Barring active notification. */

    49 		ECCESsActiveBarrings 	

    50 		};

    51 

    52     /** CLI (Call Line Information) related event. */

    53     enum TCCESsCLIEvent

    54         {

    55         /** Temporary CLIR suppression was unsuccessful */

    56         ECCESsTempClirSuppressUnsuccessful,		

    57         /** Temporary CLIR activation was unsuccessful*/

    58         ECCESsTempClirActivationUnsuccessful	

    59         };

    60 

    61     /** Call forward related events that are not call related to an existing call. */

    62     enum TCCESsCallForwardEvent

    63         {

    64         /** Incoming call is forwarded */

    65 		ECCESsIncCallIsForw, 	

    66 		/** Incoming call was forwarded because of user own settings. */

    67         ECCESsIncCallForwToC,	

    68         /** Outgoing call was forwarded because of user own settings. */

    69         ECCESsOutCallForwToC,	

    70         /** Forward unconditional mode active */

    71 		ECCESsForwardUnconditionalModeActive,  	

    72 		/** Forward unconditional mode deactive */

    73 		ECCESsForwardUnconditionalModeNotActive,

    74 		/** Forward conditional mode active */

    75 		ECCESsForwardConditionallyModeActive,	

    76 		/** Forward conditional mode deactive */

    77 		ECCESsForwardConditionallyModeNotActive,

    78 		/** Remote call waiting. TODO rename TCCESsCallForwardEvent to TCCESsCallEvent*/

    79 		ESsCallWaiting

    80         };

    81 

    82     /** Closed user group (Cug) */

    83     enum TCCESsCugEvent

    84         {

    85         ECCESsShowIncCallGroupIndex,

    86         ECCESsRejectedCause

    87         };

    88 

    89 public:

    90 

    91     /**

    92     * Supplementary service call barring event occurred.

    93     * @param aBarringEvent Event that occurred.

    94     * @return none

    95     * @since S60 v3.2

    96     */

    97 	virtual void BarringEventOccurred( const MCCESsObserver::TCCESsBarringEvent aBarringEvent ) = 0;

    98 								  

    99     /**

   100     * Supplementary service call line identification event occurred.

   101     * @param aCallLineEvent Event that occurred.

   102     * @return none

   103     * @since S60 v3.2

   104     */

   105 	virtual void CLIEventOccurred( const MCCESsObserver::TCCESsCLIEvent aCallLineEvent ) = 0;

   106 								  

   107 

   108     /**

   109     * Supplementary service related call forward event occurred.

   110     * @param aForwardMode Forward mode

   111 	* @param aRemoteAddress Remote address.

   112     * @return none

   113     * @since S60 v3.2

   114     */

   115 	virtual void CallForwardEventOccurred( 

   116 						const MCCESsObserver::TCCESsCallForwardEvent aCallForwardEvent,

   117 						const TDesC& aRemoteAddress ) = 0;

   118 

   119     /**

   120     * Supplementary service related active closed user group indications.

   121     * @param aCugEvent Event that occurred.

   122     * @return none

   123     * @since S60 v3.2

   124     */

   125 	virtual void CallCugEventOccurred( const MCCESsObserver::TCCESsCugEvent aCugEvent ) = 0;

   126 

   127     /**

   128     * Notifies active ALS line. CS plugin will notify this every time line changes 

   129 	* and at startup.

   130     * @param aLine Used ALS line.

   131     * @return none

   132     * @since S60 v3.2

   133     */

   134 	virtual void NotifyCurrentActiveALSLine( TInt aLine ) = 0;

   135 

   136     };

   137 

   138 

   139 #endif // MCCESSOBSERVER_H

   140