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: Observer interface for active idle engine

    15 *

    16 */

    17 

    18 

    19 #ifndef __FMRADIOACTIVEIDLEENGINENOTIFYHANDLER_H__

    20 #define __FMRADIOACTIVEIDLEENGINENOTIFYHANDLER_H__

    21 

    22 #include <fmradiointernalpskeys.h>

    23 

    24 /**

    25 * Observer interface for active idle engine.

    26 * The observer is notified about the changes in relevant keys through this interface.

    27 */

    28 NONSHARABLE_CLASS(MFMRadioActiveIdleEngineNotifyHandler)

    29     {

    30     public:

    31     

    32         /**

    33         * Invoked when the radio volume has changed.

    34         * @param    aVolume     The new radio volume.

    35         */

    36         virtual void HandleRadioVolumeChangeL( TInt aVolume ) = 0;

    37         

    38         /**

    39         * Invoked when tuning has taken more than one second, or tuning was previously on, but now completed.

    40         * @param    aTuningState    The new tuning state.

    41         */

    42         virtual void HandleTuningStateChangeL( TFMRadioPSTuningState aTuningState ) = 0;

    43         

    44         /**

    45         * Invoked when a new channel has been tuned into.

    46         * @param    aIndex      The index of the channel.

    47         */

    48         virtual void HandleChannelChangeL( TInt aIndex ) = 0;

    49         

    50         /**

    51         * Invoked when a channel has been modifed.

    52         * @param    aIndex    The index of the channel that was modified.

    53         */

    54         virtual void HandleChannelModifyL( TInt aIndex ) = 0;

    55 

    56         /**

    57         * Invoked when the frequency has changed.

    58         * @param    aFrequency      The new frequency.

    59         */

    60         virtual void HandleFrequencyChangeL( TInt aFrequency ) = 0;

    61         

    62         /**

    63         * Invoked when the muting state has changed.

    64         * @param    aMuteState    The new mute state.

    65         */

    66         virtual void HandleMuteStateChangeL( TFMRadioPSRadioMuteState aMuteState ) = 0;

    67 

    68         /**

    69         * Invoked when the application's running state has changed.

    70         * @param    aRunningState   The new running state.

    71         */

    72         virtual void HandleApplicationRunningStateChangeL( TFMRadioPSApplicationRunningState aRunningState ) = 0;

    73 

    74         /**

    75         * Invoked when the used decimal count is changed.

    76         * @param    aDecimalCount   The new decimal count.

    77         */

    78         virtual void HandleFrequencyDecimalCountChangeL( TFMRadioPSFrequencyDecimalCount aDecimalCount ) = 0;

    79         

    80         /**

    81         * Invoked when the antenna's connectivity status is changed.

    82         * @param    aAntennaStatus      Antenna's new connectivity status.

    83         */

    84         virtual void HandleAntennaStatusChangeL( TFMRadioPSHeadsetStatus aAntennaStatus ) = 0;

    85         

    86         /**

    87         * Invoked when radio's power state changes.

    88         * @param    aPowerState      The new power state.

    89         */

    90         virtual void HandlePowerStateChangeL( TFMRadioPSRadioPowerState aPowerState ) = 0;

    91         

    92         /**

    93         * Invoked when RDS Program Service information changes.

    94         * @param    aProgramService      New Program Service info.

    95         */

    96         virtual void HandleRDSProgramServiceChangeL( const TDesC& aProgramService ) = 0;

    97 

    98         /**

    99         * Invoked when RDS Text information changes.

   100         * @param    aRdsText      New Program Service info.

   101         */        

   102         virtual void HandleRDSRadioTextChangeL( const TDesC& aRdsText ) = 0;

   103 

   104         /**

   105         * Invoked when Channel name changes.

   106         * @param    aName      New channel name.

   107         */  

   108         virtual void HandleChannelNameChangeL( const TDesC& aName ) = 0;

   109         

   110         virtual void HandlePresetListCountChangeL( TInt aPresetCount ) = 0;

   111         virtual void HandlePresetListFocusChangeL( TInt aPresetFocus ) = 0;

   112     };

   113 

   114 #endif // __FMRADIOACTIVEIDLEENGINENOTIFYHANDLER_H__

   115