appinstall_plat/sifui_api/inc/sifui.h
changeset 37 6e7b00453237
parent 29 26b6f0522fd8
child 42 d17dc5398051
equal deleted inserted replaced
33:8110bf1194d1 37:6e7b00453237
    27 
    27 
    28 #include <e32base.h>                            // CBase
    28 #include <e32base.h>                            // CBase
    29 
    29 
    30 class CSifUiPrivate;
    30 class CSifUiPrivate;
    31 class CApaMaskedBitmap;
    31 class CApaMaskedBitmap;
       
    32 class CSifUiCertificateInfo;
       
    33 class CSifUiAppInfo;
       
    34 
    32 namespace Swi {
    35 namespace Swi {
    33     class CAppInfo;
    36     class CAppInfo;
    34     class CCertificateInfo;
    37     class CCertificateInfo;
    35 }
    38 }
    36 
    39 
    70          * changes the dialog to installation progress note. And finally, ShowFailedL()
    73          * changes the dialog to installation progress note. And finally, ShowFailedL()
    71          * or ShowCompleteL() changes the dialog to the final error or complete note.
    74          * or ShowCompleteL() changes the dialog to the final error or complete note.
    72          * If the installation confirmation query should contain memory selection option,
    75          * If the installation confirmation query should contain memory selection option,
    73          * then set the selectable drives with SetMemorySelectionL() first. User selected
    76          * then set the selectable drives with SetMemorySelectionL() first. User selected
    74          * drive can be retrieved with SelectedDrive().
    77          * drive can be retrieved with SelectedDrive().
    75          * @param aAppInfo - application information (name, version, and vendor)
    78          * @param aAppInfo - application information (name, size, version, vendor, icon)
    76          * @param aAppSize - application size in bytes, not displayed if zero
       
    77          * @param aAppIcon - application icon, default icon is displayed if NULL
       
    78          * @return TBools - ETrue if user accepted the query, EFalse otherwise
    79          * @return TBools - ETrue if user accepted the query, EFalse otherwise
    79          */
    80          */
    80         IMPORT_C TBool ShowConfirmationL( const Swi::CAppInfo& aAppInfo,
    81         IMPORT_C TBool ShowConfirmationL( const CSifUiAppInfo& aAppInfo );
    81                 TInt aAppSize = 0, const CApaMaskedBitmap* aAppIcon = NULL );
       
    82 
    82 
    83         /**
    83         /**
    84          * Defines memory selection alternatives for the main installation
    84          * Defines memory selection alternatives for the main installation
    85          * confirmation query displayed with ShowConfirmationL() function.
    85          * confirmation query displayed with ShowConfirmationL() function.
    86          * @param aDriveNumbers - options for memory selection
    86          * @param aDriveNumbers - options for memory selection
    99          * Defines certificate details for the main installation confirmation
    99          * Defines certificate details for the main installation confirmation
   100          * query displayed with ShowConfirmationL() function.
   100          * query displayed with ShowConfirmationL() function.
   101          * @param aCertificates - certificate details
   101          * @param aCertificates - certificate details
   102          */
   102          */
   103         IMPORT_C void SetCertificateInfoL(
   103         IMPORT_C void SetCertificateInfoL(
   104                 const RPointerArray<Swi::CCertificateInfo>& aCertificates );
   104                 const RPointerArray<CSifUiCertificateInfo>& aCertificates );
   105 
   105 
   106         /**
   106         /**
   107          * Displays main installation progress note. If the progress note or main
   107          * Displays main installation progress note. If the progress note or main
   108          * confirmation query is already displayed, then updates the dialog content.
   108          * confirmation query is already displayed, then updates the dialog content.
   109          * Use IncreaseProgressBarValueL() to increase the progress bar value.
   109          * Use IncreaseProgressBarValueL() to increase the progress bar value.
   110          * Dialog remains on the screen after progress bar shows full 100% value.
   110          * Dialog remains on the screen after progress bar shows full 100% value.
   111          * Use ShowFailedL() or ShowCompleteL() to replace the dialog content
   111          * Use ShowFailedL() or ShowCompleteL() to replace the dialog content
   112          * with the final error or complete note.
   112          * with the final error or complete note.
   113          * @param aAppInfo - application information (name, version, and vendor)
   113          * @param aAppInfo - application information (name, size, version, vendor, icon)
   114          * @param aAppSize - application size in bytes (not displayed if zero)
       
   115          * @param aProgressBarFinalValue - final value of the progress bar
   114          * @param aProgressBarFinalValue - final value of the progress bar
   116          */
   115          */
   117         IMPORT_C void ShowProgressL( const Swi::CAppInfo& aAppInfo,
   116         IMPORT_C void ShowProgressL( const CSifUiAppInfo& aAppInfo, TInt aProgressBarFinalValue );
   118                 TInt aAppSize, TInt aProgressBarFinalValue );
       
   119 
   117 
   120         /**
   118         /**
   121          * Updates the progress bar value displayed in progress note. Initially progress bar
   119          * Updates the progress bar value displayed in progress note. Initially progress bar
   122          * shows 0%. Each aIncrement increases the value displayed in progress bar. When all
   120          * shows 0%. Each aIncrement increases the value displayed in progress bar. When all
   123          * increments reach the final value defined in ShowProgressNoteL() method, then the
   121          * increments reach the final value defined in ShowProgressNoteL() method, then the
   151             EUninstalling = 2
   149             EUninstalling = 2
   152         };
   150         };
   153         IMPORT_C void SetMode( TMode aMode );
   151         IMPORT_C void SetMode( TMode aMode );
   154         IMPORT_C TMode Mode();
   152         IMPORT_C TMode Mode();
   155         IMPORT_C void ShowFailedL( TInt aErrorCode );
   153         IMPORT_C void ShowFailedL( TInt aErrorCode );
       
   154         IMPORT_C void SetCertificateInfoL(
       
   155                 const RPointerArray<Swi::CCertificateInfo>& aCertificates );
       
   156         IMPORT_C TBool ShowConfirmationL( const Swi::CAppInfo& aAppInfo,
       
   157                 TInt aAppSize = 0, const CApaMaskedBitmap* aAppIcon = NULL );
       
   158         IMPORT_C void ShowProgressL( const Swi::CAppInfo& aAppInfo,
       
   159                  TInt aAppSize, TInt aProgressBarFinalValue );
   156 
   160 
   157     private:    // new functions
   161     private:    // new functions
   158         CSifUi();
   162         CSifUi();
   159         void ConstructL();
   163         void ConstructL();
   160 
   164