1 /*

     2 * Copyright (c) 2004-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 handling features

    15 *

    16 */

    17 

    18 

    19 #ifndef MVTUIFEATURE_H

    20 #define MVTUIFEATURE_H

    21 

    22 //  INCLUDES

    23 #include <e32std.h>

    24 

    25 #include "tvtuifeatureids.h"

    26 

    27 // CLASS DECLARATION

    28 

    29 /**

    30 *  Interface for handling features

    31 *

    32 *  @since S60 v3.2

    33 */

    34 class MVtUiFeature

    35     {

    36     public:  // New functions

    37         /**

    38         * ENotSupported

    39         *  feature is not supported in current configuration.

    40         * EUnprepared

    41         *   starting may require some init code to run.

    42         * EPreparing

    43         *   running initialization code.

    44         * EReady

    45         *   feature can be started.

    46         * EActive

    47         *   feature is running.

    48         * EDisabled

    49         *   feature is supported but cannot be started at this time.

    50         * EFailed

    51         *   started but failed (maybe temporary or permanent, feature specific)

    52         */

    53         enum TVtUiFeatureState

    54             {

    55             ENotSupported,

    56             EUnprepared,

    57             EPreparing,

    58             EReady,

    59             EActive,

    60             EDisabled,

    61             EFailed

    62             };

    63 

    64         /**

    65         * Starts the feature.

    66         */

    67         virtual void StartL() = 0;

    68 

    69         /**

    70         * Stops the feature.

    71         */

    72         virtual void Stop() = 0;

    73 

    74         /**

    75         * Current state of the feature

    76         */

    77         virtual TVtUiFeatureState State() const = 0;

    78 

    79         /**

    80         * Id()

    81         */

    82         virtual TVtUiFeatureId Id() const = 0;

    83     };

    84 

    85 #endif // MVTUIFEATURE_H

    86 // End of File