1 /*

     2 * Copyright (c) 2003 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:  Service Settings UI

    15 *

    16 */

    17 

    18 

    19 

    20 #ifndef CWVSETTINGSUIDIALOG_H

    21 #define CWVSETTINGSUIDIALOG_H

    22 

    23 

    24 //  INCLUDES

    25 #include <e32base.h>

    26 #include <akndialog.h>

    27 

    28 // DATA TYPES

    29 

    30 enum TWVSettingsDialogReturnValue

    31     {

    32     EWVSettingsViewOk,

    33     EWVSettingsViewExitCalled,

    34     EWVSettingsViewForceExit

    35     };

    36 

    37 

    38 enum TWVSettingsDialogType

    39     {

    40     EWVSettingsNormal,

    41     EWVSettingsDefineServer

    42     };

    43 

    44 enum TExitReasons

    45     {

    46     EServerSaved = 0,

    47     EMissingCompulsory, // server not saved

    48     EApplicationExit,

    49     ENotSaved,

    50     EForcedExit

    51     };

    52 

    53 

    54 // FORWARD DECLARATIONS

    55 class CIMPSSAPSettingsStore;

    56 class MWVSettingsObserver;

    57 class MWVSettingsCASettings;

    58 

    59 // CLASS DECLARATION

    60 

    61 /**

    62 *  Server settings dialog

    63 *  Basicly this dialog gives that two links to other dialogs, to current

    64 *  server selection and to server list

    65 *

    66 *  @lib WVServiceSettingsUi.dll

    67 *  @since 2.1

    68 */

    69 class CWVSettingsUIDialog : public CAknDialog

    70     {

    71 

    72     public: // New functions

    73 

    74         /**

    75         * Two-phased constructor.

    76         */

    77         IMPORT_C static CWVSettingsUIDialog* NewL();

    78 

    79         /**

    80         * Runs the dialog.

    81         * @param aSAPSettingsStore Pointer to SAP settings store

    82         * @param aObserver Pointer to the UI observer

    83         * @param aResourceFile The path to a branded resource file wanted to be used

    84         * @param aResourceVariationFile	 The variation file name that contains the settings

    85         * @param aExitReason The exit reason of the dialog

    86         * @param aWhatToRun Tells whether to run the whole dialog

    87         *                   or just the new server definition dialog

    88         */

    89         virtual TWVSettingsDialogReturnValue RunDialogLD (

    90             CIMPSSAPSettingsStore& aSAPSettingsStore,

    91             MWVSettingsObserver* aObserver,

    92             const TDesC& aResourceFile,

    93             const TDesC& aResourceVariationFile,

    94             TInt& aExitReason,

    95             MWVSettingsCASettings* aCAServerSettings,

    96             CWVSettingsUIDialog** aSelfPtr,

    97             TBool aForcedLaunch = EFalse,

    98             TWVSettingsDialogType aDialogType = EWVSettingsNormal ) = 0;

    99 

   100         /**

   101         * Changes the resource file used

   102         * @param aResourceFileName The path to the resource file wanted to be used

   103         * @param aResourceVariationFile	The file name of the variation file to be changed.

   104         */

   105         virtual void ChangeResourceFileL ( const TDesC& aResourceFileName,

   106                                            const TDesC& aResourceVariationFile ) = 0;

   107 

   108     protected:

   109 

   110         /**

   111         * C++ default constructor.

   112         */

   113         CWVSettingsUIDialog();

   114 

   115         /**

   116         * Destructor.

   117         */

   118         virtual ~CWVSettingsUIDialog();

   119 

   120     };

   121 

   122 #endif      // CWVSETTINGSUIDIALOG_H

   123 

   124 // End of File