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

 *                                                            *

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

 *                                                            *

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

#include <bamdesca.h>                           // MDesCArray

class CSifUiErrorInfo;

        //=================================================

        // Preparing note method

        //=================================================

         * Displays installation dialog with "Preparing" text and indefinite progress bar.

         * No buttons are available. Use ShowConfirmationL() method to update the dialog

         * content to the installation confirmation query.

         */

        IMPORT_C void ShowPreparingL();

        //=================================================

        // Install confirmation query methods

        //=================================================

        /**

         * Defines memory selection alternatives for the ShowConfirmationL() installation

         * confirmation query. Use SelectedDrive() method to get the selected drive number

         * after ShowConfirmationL() call.

         * Defines certificate details for the ShowConfirmationL() installation

         * confirmation query. If certificates are not set, then application is

         * untrusted.

         * @param aCertificates - certificate details

         */

        IMPORT_C void SetCertificateInfoL(

                const RPointerArray<CSifUiCertificateInfo>& aCertificates );

        /**

         * Displays installation confirmation query and waits for user response.

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

         * changes the dialog content to installation progress note. And finally,

         * ShowCompleteL() or ShowFailedL() call changes the dialog content to the

         * complete or error note.

         * If preparing installation note needs to be displayed before confirmation query,

         * then call ShowPreparingL() before any other functions.

         * 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() after ShowConfirmationL() returns.

         * If the installation confirmation query should contain certificate details, then

         * set the certificate details using SetCertificateInfoL() first.

         * @param aAppInfo - application information (name, size, version, vendor, icon)

         * @return TBools - ETrue if the user accepted the query, EFalse otherwise

         */

        IMPORT_C TBool ShowConfirmationL( const CSifUiAppInfo& aAppInfo );

        /**

        //=================================================

        // Progress note methods

        //=================================================

         * Installing phases in progress notes. Indicated in progress note title text.

         */

        enum TInstallingPhase {

            EInstalling,

            EDownloading,

            ECheckingCerts

        };

        /**

         * Displays installation progress note. Changes confirmation query content

         * to progress note. If the progress note is already displayed, then updates

         * the dialog content. Use IncreaseProgressBarValueL() method to increase the

         * progress bar value.

         * Use ShowCompleteL() or ShowFailedL() methods to show the result.

         * @param aPhase - defines new title text for the progress note dialog

        IMPORT_C void ShowProgressL( const CSifUiAppInfo& aAppInfo, TInt aProgressBarFinalValue,

                TInstallingPhase aPhase = EInstalling );

        //=================================================

        // Final complete and error notes

        //=================================================

        /**

         * Displays installation complete note and waits for the user to close it.

         * Installation complete note contains "Show" button to show installed

         * applications in application library. Use SetButtonVisible() method to

         * hide the "Show" button when necessary.

         */

        IMPORT_C void ShowCompleteL();

        /**

         * Displays installation error note and waits for user to close it.

         * Installation error note contains "Details" button to show the detailed

         * error message (when available). Also SetButtonVisible() method can be

         * used to hide the "Details" button if necessary.

         * @param aErrorCategory - error category

         * @param aErrorMessage - localized error message to be displayed

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

         * @param aErrorCode - error code

         * @param aErrorCode - error code

         */

        IMPORT_C void ShowFailedL( const CSifUiErrorInfo& aErrorInfo );

        //=================================================

        // Buttons in progress/complete/error notes

        //=================================================

            EHideProgressButton,        // "Hide" button in progress note

            ECancelProgressButton,      // "Cancel" button in progress note

            EShowInAppLibButton,        // "Show" button in complete note

            EErrorDetailsButton         // "Details" button in error note

        //=================================================

        // Other query dialogs

        //=================================================

         * Displays dialog requesting capabilities for the application being installed

         * and waits for user response. Returns ETrue if the user granted the capabilities.

         * Other dialogs (like progress note) are not affected.

         * @param aCapabilities - requested user capabilities

         * @return TBool - ETrue if the user granted the capabilities, EFalse otherwise

        IMPORT_C TBool ShowGrantCapabilitiesL( const TCapabilitySet& aCapabilities );

         * Displays a selection dialog with radio-buttons in a pop-up window,

         * and waits for user response. Other displayed installation dialogs

         * (like progress note) are not affected. Returns boolean that indicates

         * if the user cancelled the query. Selected item index is returned in

         * aSelectedIndex parameter (KErrNotFound if cancelled).

         * @param aTitle - selection dialog title

         * @param aSelectableItems - array of selectable items

         * @param aSelectedIndex - returns selected item index

         * @return TBool - ETrue if the user accepted the query, EFalse otherwise

        IMPORT_C TBool ShowSingleSelectionL( const TDesC& aTitle,

            const MDesCArray& aSelectableItems, TInt& aSelectedIndex );

        /**

         * Displays a multi-selection dialog with checkboxes in a pop-up window,

         * and waits for user response. Other displayed installation dialogs

         * (like progress note) are not affected. Returns user selected indices,

         * in aSelectedIndexes array (empty if cancelled).

         * @param aTitle - multi-selection dialog title

         * @param aSelectableItems - array of selectable items

         * @param aSelectedIndexes - returns the selected item indices

         * @return TBool - ETrue if the user accepted the query, EFalse otherwise

         */

        IMPORT_C TBool ShowMultiSelectionL( const TDesC& aTitle,

            const MDesCArray& aSelectableItems, RArray<TInt>& aSelectedIndexes );

        //=================================================

        // DEPRECATED METHODS

        //=================================================

        // DEPRECATED, WILL BE REMOVED, DO NOT USE