uiservicetab/vimpstutils/inc/vimpstutilswaitnote.h
branchRCL_3
changeset 29 9a48e301e94b
parent 0 5e5d6b214f4f
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/uiservicetab/vimpstutils/inc/vimpstutilswaitnote.h	Wed Sep 01 12:33:36 2010 +0100
@@ -0,0 +1,159 @@
+/*
+* Copyright (c) 2006 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:  Helper class for wait notes
+*
+*/
+
+
+
+#ifndef CVIMPSTUTILSWAITNOTE_H
+#define CVIMPSTUTILSWAITNOTE_H
+
+//  INCLUDES
+#include <AknWaitDialog.h>
+
+// FORWARD DECLARATIONS
+
+// CLASS DECLARATION
+
+
+// Observer class to notice dismissing note by cancel.
+class MVIMPSTUtilsWaitNoteObserver
+    {
+    public: // Interface methods
+    
+        /**
+         * Wait note is canceled.
+         */
+        virtual void NoteCanceled( TInt aButtonId ) = 0;    
+    };
+
+/**
+ *  Helper class for wait notes
+ *
+ *  @lib chat.exe
+ *  @since 
+ */
+class CVIMPSTUtilsWaitNote : public CBase, public MProgressDialogCallback
+    {
+    public:  // Constructors and destructor
+
+        /**
+         * Shows waitnote and pushes the item to cleanupstack
+         *
+         * @param aText 				Text to be shown in note.
+         * @param aShowImmediately 		If ETrue waitnote is shown immediately
+         *								(not after 1 sec delay)
+         * @param aCanBeCanceledByUser  Do we show wait note with cancel soft key or not
+         */
+        IMPORT_C static CVIMPSTUtilsWaitNote* ShowWaitNoteLC( const TDesC& aText,
+        									TBool aShowImmediately = EFalse,
+        									TBool aCanBeCanceledByUser = EFalse, 
+        									MVIMPSTUtilsWaitNoteObserver* aObserver = NULL );
+
+		/**
+         * Shows waitnote,does not leave anything to cleanupstack.
+         *
+         * @param aText 				Text to be shown in note.
+         * @param aShowImmediately 		If ETrue waitnote is shown immediately
+         *								(not after 1 sec delay)
+         * @param aCanBeCanceledByUser  Do we show wait note with cancel soft key or not
+         */
+        IMPORT_C static CVIMPSTUtilsWaitNote* ShowWaitNoteL( const TDesC& aText,
+        									TBool aShowImmediately = EFalse,
+        									TBool aCanBeCanceledByUser = EFalse, 
+        									MVIMPSTUtilsWaitNoteObserver* aObserver = NULL );
+        									
+
+		/**
+         * Shows waitnote and pushes the item to cleanupstack
+         *
+         * @param aTextResource 		Resource id of text to be shown in note.
+         * @param aShowImmediately 		If ETrue waitnote is shown immediately
+		 *								(not after 1 sec delay)
+         * @param aCanBeCanceledByUser  Do we show wait note with cancel soft key or not
+         */
+        IMPORT_C static CVIMPSTUtilsWaitNote* ShowWaitNoteLC( TInt aTextResource,
+        									TBool aShowImmediately = EFalse,
+        								    TBool aCanBeCanceledByUser = EFalse, 
+        								    MVIMPSTUtilsWaitNoteObserver* aObserver = NULL );
+		
+		/**
+         * Shows waitnote, does not leave anything to cleanupstack.
+         *
+         * @param aTextResource 		Resource id of text to be shown in note.
+         * @param aShowImmediately 		If ETrue waitnote is shown immediately
+		 *								(not after 1 sec delay)
+         * @param aCanBeCanceledByUser  Do we show wait note with cancel soft key or not
+         */
+        IMPORT_C static CVIMPSTUtilsWaitNote* ShowWaitNoteL( TInt aTextResource,
+        								   TBool aShowImmediately = EFalse,
+        								   TBool aCanBeCanceledByUser = EFalse, 
+        								   MVIMPSTUtilsWaitNoteObserver* aObserver = NULL );
+		/**
+		 * Destructor.
+		 */
+		virtual ~CVIMPSTUtilsWaitNote();
+
+    protected: // From MProgressDialogCallback
+
+        /**
+         * From MProgressDialogCallback Get's called when a dialog is dismissed
+         * @param aButtonId Button that was used to dismiss the dialog
+         */
+        IMPORT_C void DialogDismissedL( TInt aButtonId );
+
+
+	public: // New functions
+
+		/**
+         * Dismisses this waitnote
+		 */
+		IMPORT_C void DismissDialog();
+
+
+    private:
+
+        /**
+         * C++ default constructor.
+         */
+        CVIMPSTUtilsWaitNote();
+
+        /**
+         * By default Symbian 2nd phase constructor is private.
+         */
+        void ConstructL( const TDesC& aText,
+        		  		 TBool aShowImmediately,
+        				 TBool aCanBeCanceledByUser,
+        				 MVIMPSTUtilsWaitNoteObserver* aObserver );
+
+    public: // New methods
+   
+        /**
+         * Set wait note observer. NULL will unset this one.
+         */
+        IMPORT_C void SetObserver( MVIMPSTUtilsWaitNoteObserver* aObserver );
+
+    private: // Data
+
+    	// Doesn't own (destroys itself)
+		CAknWaitDialog* iWaitDialog;
+       
+        /// Wait note observer. This will be notified when wait note is dismissed.
+        MVIMPSTUtilsWaitNoteObserver* iObserver;
+    };
+
+#endif      // CCAWAITNOTE_H
+
+// End of File