/********************************************************

 *                                                      *

 *   WARNING - WORK-IN-PROGRESS - THIS API MAY CHANGE   *

 *                                                      *

 ********************************************************/

#include <e32base.h>                            // CBase

class CSifUiPrivate;

 * global and they can be used in a non-UI code (like SIF plugins).

 * @lib sifui.lib

class CSifUi : public CBase

         * Displays main installation confirmation query and waits for user response.

         * Returns ETrue if user accepted the query. The next ShowProgressL() call

         * changes the dialog to installation progress note. And finally, ShowFailedL()

         * or ShowCompleteL() changes the dialog to the final error or complete note.

         * If the installation confirmation query should contain memory selection option,

         * then set the selectable drives with SetMemorySelectionL() first. User selected

         * drive can be retrieved with SelectedDrive().

         * @param aAppSize - application size in bytes, not displayed if zero

                TInt aAppSize = 0, const CApaMaskedBitmap* aAppIcon = NULL );

        /**

         * Defines memory selection alternatives for the main installation

         * confirmation query displayed with ShowConfirmationL() function.

         * @param aDriveNumbers - options for memory selection

         */

        IMPORT_C void SetMemorySelectionL( const RArray<TInt>& aDriveNumbers );

        /**

         * Gets the selected drive where new component should be installed.

         * Use RFs::DriveToChar() to convert the drive number to drive letter.

         * @param aDriveNumber - selected drive number

         * @return TInt - KErrNone if successful, otherwise Symbian error code

         */

        IMPORT_C TInt SelectedDrive( TInt& aDriveNumber );

        /**

         * Defines certificate details for the main installation confirmation

         * query displayed with ShowConfirmationL() function.

         * @param aCertificates - certificate details

         */

        IMPORT_C void SetCertificateInfoL(

         * Displays main installation progress note. If the progress note or main

         * confirmation query is already displayed, then updates the dialog content.

         * Use IncreaseProgressBarValueL() to increase the progress bar value.

         * Dialog remains on the screen after progress bar shows full 100% value.

         * Use ShowFailedL() or ShowCompleteL() to replace the dialog content

         * with the final error or complete note.

         * Displays main installation complete note. Installation complete note contains

         * button to launch the application libaray to show the recently installed apps.

         * Displays main installation error note. Installation error note contains button

         * to see detailed error message when available.

         * @param aErrorMessage - localized error message to be displayed

         * @param aErrorDetails - localized error message details (if any)

        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 );

        CSifUiPrivate* iPrivate;