1 /*

     2 * Copyright (c) 2009-2010 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:  Utility methods for universal usage

    15 *  Interface   : Private, CVmbxUiUtilities

    16 *

    17 */

    18 

    19 #ifndef C_VMBXUIUTILITIES_H

    20 #define C_VMBXUIUTILITIES_H

    21 

    22 // INCLUDES

    23 #include <e32base.h>

    24 #include <cvoicemailbox.h>

    25 

    26 #include "mvmbxuiutilities.h"

    27 #include "vmbxuihandler.h"

    28 

    29 // FORWARD DECLARATIONS

    30 

    31 

    32 // CLASS DECLARATION

    33 /**

    34 *  Implementation of the auxiliary methods for the VMBX engine classes

    35 *

    36 *  @lib vmbxengine.lib

    37 */

    38 NONSHARABLE_CLASS( CVmbxUiUtilities ): public CBase,

    39                                        public MVmbxUiUtilities

    40     {

    41 

    42 public:

    43 

    44     /**

    45      * Two-phased constructor

    46      */

    47     static CVmbxUiUtilities* NewL();

    48 

    49     /**

    50      * Destructor.

    51      */

    52     ~CVmbxUiUtilities();

    53 

    54     /**

    55      * Show mailbox query

    56      *

    57      * @param in aType TVmbxType type

    58      * @param in aMode TVmbxQueryMode mode

    59      * @param out aNumber the voice mailbox number

    60      */

    61     void ShowQueryL( const TVmbxType& aType,

    62                     const TVmbxQueryMode& aMode,

    63                     TDes& aNumber );

    64 

    65     /**

    66      * Show informationd note

    67      *

    68      * @param aType in TVmbxNoteType type

    69      */

    70     void ShowInformationdNoteL(const TVmbxNoteType aType);

    71  

    72     /**

    73      * Show define number in selection dialog

    74      * Leaves if user cancel selected.

    75      *

    76      * @param in aType vmbx type

    77      * @param out aResult the result of dialog

    78      */

    79     void ShowDefineSelectionDialogL( TVmbxType& aType, TInt& aResult );

    80 

    81     /**

    82      * Show call number in selection dialog

    83      * Leaves if user cancel selected.

    84      *

    85      * @param in aArray array of the defined voice mailbox entry

    86      * @param in aIcons icons of the defined voice mailbox

    87      * @param out aParams the type TVoiceMailboxParams which should include

    88      *          the service id and the type of seclected TVmbxType

    89      * @param out aResult the result user seclected

    90      */

    91     void ShowCallSelectionDialogL(

    92                 const RPointerArray<CVoiceMailboxEntry>& aArray,

    93                 //CArrayPtr<CGulIcon>* aIcons,

    94                 TVoiceMailboxParams& aParams, TInt& aResult );

    95 

    96     /**

    97      * Get Mailbox type default image.

    98      * If get unseccessful, Leaves with Symbian OS error code

    99      *

   100      * @param aParams Mailbox type for which image is needed.

   101      * @return aImage New image. Ownership is transferred.

   102      */

   103     //CGulIcon* GetVmbxImageL( const TVoiceMailboxParams& aParams );

   104 

   105     /**

   106      * Show not allowed editing dialog

   107      *

   108      */

   109     void ShowNotAllowedEditingDialogL();

   110 

   111     /**

   112      * Show invalid or warning dialog

   113      *

   114      */

   115     void ShowInvalidWarningDialogL();

   116 

   117      /**

   118      * Tries to close all open dialogs

   119      *

   120      */

   121     void DismissDialogL();   

   122 

   123 private: // data

   124 

   125     /**

   126      * C++ default constructor.

   127      */

   128     CVmbxUiUtilities();

   129 

   130     /**

   131      * C++  Two-phased constructor.

   132      */

   133     void ConstructL();

   134 

   135     /**

   136      * Show mailbox query dialog

   137      * Leaves if user cancel selected.

   138      *

   139      * @param aType in TVmbxType type

   140      * @param aMode Tin VmbxQueryMode mode

   141      * @param aNumber the voice mailbox number

   142      * @param aResult out the result of dialog

   143      */

   144     void ShowQueryDialogL( const TVmbxType& aType,

   145         const TVmbxQueryMode & aMode, TDes& aNumber, TInt& aResult );

   146 

   147     /**

   148     * Open phonebook's Single Fetch Dialog

   149     * @param aPhoneNumber Phone number

   150     */

   151     void FetchNumberFromPhonebook2L( TDes& aPhoneNumber );

   152 

   153 private:

   154 

   155     /**

   156      * Ui handler

   157      * Own.

   158      */

   159     CVmbxUiHandler* iUiHandler;

   160     };

   161 

   162 #endif  // C_VMBXUIUTILITIES_H