1 /*

     2 * Copyright (c) 2007-2008 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:  Declarition of CAcpDialog

    15 *

    16 */

    17 

    18 

    19 #ifndef ACPDIALOG_H

    20 #define ACPDIALOG_H

    21 

    22 #include <e32base.h>

    23 

    24 class CAknGlobalNote;

    25 class CAknGlobalMsgQuery;

    26 class MAcpDialogObserver;

    27     

    28 /**

    29  *  CAcpDialog class

    30  *  Declarition of CAcpDialog.

    31  *

    32  *  @lib accountcreationplugin.lib

    33  *  @since S60 v3.2

    34  */

    35 NONSHARABLE_CLASS( CAcpDialog ) : public CActive

    36     {

    37 public:

    38 

    39     /**

    40      * Two-phased constructor.

    41      *

    42      * @param aObserver Dialog observer.

    43      */

    44     static CAcpDialog* NewL( MAcpDialogObserver& aObserver );

    45 

    46     /**

    47      * Two-phased constructor.

    48      *

    49      * @param aObserver Dialog observer.

    50      */

    51     static CAcpDialog* NewLC( MAcpDialogObserver& aObserver );

    52 

    53     /**

    54      * Destructor.

    55      */

    56     virtual ~CAcpDialog();

    57 

    58     /**

    59      * Launches a wait note.

    60      *

    61      * @since S60 v3.2

    62      * @param aWaitNote Appropriate text.

    63      */

    64     void LaunchWaitNoteL( TInt aWaitNote );

    65 

    66     /**

    67      * Launches a wait note with a custom string.

    68      *

    69      * @since S60 v3.2

    70      * @param aWaitNote Appropriate text.

    71      * @param aString Custom string.

    72      */

    73     void LaunchWaitNoteL( TInt aWaitNote, const TDesC& aString );

    74 

    75     /**

    76      * Destroys a wait note.

    77      *

    78      * @since S60 v3.2

    79      */

    80     void DestroyWaitNote();

    81 

    82     /**

    83      * Shows query with the appropriate text.

    84      *

    85      * @since S60 v3.2

    86      * @param aQuery Text to be displayed.

    87      * @return Key pressed.

    88      */

    89     TInt ShowQueryL( TInt aQuery );

    90     

    91     /**

    92      * Shows message query with the appropriate text.

    93      *

    94      * @since S60 v5.0

    95      * @param aMessageQuery Text to be displayed.

    96      */

    97     void ShowMessageQueryL( TInt aMessageQuery, const TDesC& aString );

    98 

    99     /**

   100      * Shows note with the appropriate text.

   101      *

   102      * @since S60 v3.2

   103      * @param aNote Text to be displayed.

   104      * @param aString Text used in resource loading.

   105      */

   106     void ShowNoteL( TInt aNote, const TDesC& aString );    

   107 

   108     /**

   109      * Shows note with the appropriate text.

   110      *

   111      * @since S60 v3.2

   112      * @param aNote Text to be displayed.

   113      */

   114     void ShowGlobalNoteL( TInt aNote );

   115 

   116     /**

   117      * Shows global note with the appropriate text.

   118      *

   119      * @since S60 v3.2

   120      * @param aNote Resource id of the note.

   121      * @param aString Text used in resource loading.

   122      */

   123     void ShowGlobalNoteL( TInt aNote, const TDesC& aString );

   124     

   125     /**

   126      * Shows dialog with several lines for selection.

   127      * 

   128      * @since S60 v3.2

   129      * @param aDialog Dialog resource to use.

   130      * @param aArray Array of selections.

   131      * @return Selected index.

   132      */

   133     TInt ShowSelectionDialogL( TInt aDialog, MDesC16Array* aArray );

   134 

   135 protected:

   136 

   137 // from base class CActive

   138 

   139     /**

   140      * From CActive.

   141      * Handles request completion event.

   142      * 

   143      * @since S60 v3.2

   144      */

   145     void RunL();

   146 

   147     /**

   148      * From CActive.

   149      * Cancels an outstanding request.

   150      * 

   151      * @since S60 v3.2

   152      */

   153     void DoCancel();

   154 

   155 private:

   156 

   157     CAcpDialog( MAcpDialogObserver& aObserver );

   158 

   159 private: // data  

   160 

   161     /**

   162      * Reference for dialog observer.

   163      */

   164      MAcpDialogObserver& iObserver;

   165 

   166     /**

   167      * Global wait note.

   168      * Own.

   169      */

   170     CAknGlobalNote* iWaitNote;

   171     

   172     /**

   173      * Akn global message query 

   174      * Own.

   175      */

   176     CAknGlobalMsgQuery* iGlobalMsgQuery;

   177 

   178     /**

   179      * Global note Id

   180      */

   181     TInt iNoteId;

   182     };

   183 

   184 #endif // ACPDIALOG_H  

   185 

   186 // End of file.