appinstall_plat/sifui_api/inc/sifui.h
changeset 42 d17dc5398051
parent 37 6e7b00453237
child 55 ac7f90a6ff4c
child 60 245df5276b97
--- a/appinstall_plat/sifui_api/inc/sifui.h	Thu May 27 12:58:35 2010 +0300
+++ b/appinstall_plat/sifui_api/inc/sifui.h	Fri Jun 11 13:45:18 2010 +0300
@@ -64,7 +64,7 @@
         /**
          * Destructor.
          */
-        CSifUi::~CSifUi();
+        ~CSifUi();
 
     public:     // new functions
         /**
@@ -119,12 +119,40 @@
          * Updates the progress bar value displayed in progress note. Initially progress bar
          * shows 0%. Each aIncrement increases the value displayed in progress bar. When all
          * increments reach the final value defined in ShowProgressNoteL() method, then the
-         * progress bar shows full 100%.
+         * progress bar shows full 100%. Caller should check using IsCancelled() method if
+         * the user has cancelled the progress note before updating the progress bar value.
          * @param aIncrement - progress bar value increment
          */
         IMPORT_C void IncreaseProgressBarValueL( TInt aIncrement );
 
         /**
+         * Returns ETrue if the user has cancelled the progress dialog.
+         * @return TBool - ETrue if the progress dialog has been cancelled
+         */
+        IMPORT_C TBool IsCancelled();
+
+        /**
+         * Toolbar buttons in progress and complete notes that can be disabled/hidden.
+         */
+        enum TOptionalButton
+            {
+            EHideProgressButton,
+            ECancelProgressButton,
+            EShowInAppLibButton,
+            EErrorDetailsButton
+            };
+
+        /**
+         * Hides or shows optional toolbar buttons from installation progress note
+         * or installation complete note. All optional buttos are visible by default.
+         * Buttons visibility becomes effective in the next ShowProgressL(),
+         * ShowCompleteL(), or IncreseProgressBarValueL() method calls.
+         * @param aButton - button which visibility is changed
+         * @param aIsVisible - EFalse if button needs to be hidden
+         */
+        IMPORT_C void SetButtonVisible( TOptionalButton aButton, TBool aIsVisible );
+
+        /**
          * Displays main installation complete note. Installation complete note contains
          * button to launch the application libaray to show the recently installed apps.
          */
@@ -140,24 +168,6 @@
         IMPORT_C void ShowFailedL( TInt aErrorCode, const TDesC& aErrorMessage,
             const TDesC& aErrorDetails = KNullDesC );
 
-
-
-        /** DEPRECATED -- DO NOT USE -- WILL BE REMOVED */
-        enum TMode {
-            EUnspecified = 0,
-            EInstalling = 1,
-            EUninstalling = 2
-        };
-        IMPORT_C void SetMode( TMode aMode );
-        IMPORT_C TMode Mode();
-        IMPORT_C void ShowFailedL( TInt aErrorCode );
-        IMPORT_C void SetCertificateInfoL(
-                const RPointerArray<Swi::CCertificateInfo>& aCertificates );
-        IMPORT_C TBool ShowConfirmationL( const Swi::CAppInfo& aAppInfo,
-                TInt aAppSize = 0, const CApaMaskedBitmap* aAppIcon = NULL );
-        IMPORT_C void ShowProgressL( const Swi::CAppInfo& aAppInfo,
-                 TInt aAppSize, TInt aProgressBarFinalValue );
-
     private:    // new functions
         CSifUi();
         void ConstructL();