appinstall_plat/sifui_api/inc/sifui.h
changeset 64 48c14c385b0e
parent 58 67f2119dc623
child 69 b18a4bf55ddb
equal deleted inserted replaced
58:67f2119dc623 64:48c14c385b0e
   238          * @return TBool - ETrue if the user granted the capabilities, EFalse otherwise
   238          * @return TBool - ETrue if the user granted the capabilities, EFalse otherwise
   239          */
   239          */
   240         IMPORT_C TBool ShowGrantCapabilitiesL( const TCapabilitySet& aCapabilities );
   240         IMPORT_C TBool ShowGrantCapabilitiesL( const TCapabilitySet& aCapabilities );
   241 
   241 
   242         /**
   242         /**
   243          * Displays a selection dialog with radio-buttons in a pop-up window,
   243          * Displays pop-up language selection dialog with radio-buttons, and
   244          * and waits for user response. Other displayed installation dialogs
   244          * waits for user response. Other displayed installation dialogs (like
   245          * (like progress note) are not affected. Returns boolean that indicates
   245          * progress note) are not affected. Returns integer that is the index
   246          * if the user cancelled the query. Selected item index is returned in
   246          * of the selected language in given langauge array, or error code.
   247          * aSelectedIndex parameter (KErrNotFound if cancelled).
   247          * Return value is KErrCancel if the user cancelled the query.
   248          * @param aTitle - selection dialog title
   248          * @param aLanguages - array of selectable languages
   249          * @param aSelectableItems - array of selectable items
   249          * @return The selected item index to aLangauges array, or error code.
   250          * @param aSelectedIndex - returns selected item index
   250          */
   251          * @return TBool - ETrue if the user accepted the query, EFalse otherwise
   251         IMPORT_C TInt ShowSelectLanguageL( const RArray<TLanguage>& aLanguages );
   252          */
   252 
   253         IMPORT_C TBool ShowSingleSelectionL( const TDesC& aTitle,
   253         /**
   254             const MDesCArray& aSelectableItems, TInt& aSelectedIndex );
   254          * Displays multi-selection pop-up dialog with checkboxes, and waits
   255 
   255          * for user response. Other displayed installation dialogs (like progress
   256         /**
   256          * note) are not affected. Returns ETrue if the user made the selection,
   257          * Displays a multi-selection dialog with checkboxes in a pop-up window,
   257          * EFalse if the user cancelled the query. Selected indices are returned
   258          * and waits for user response. Other displayed installation dialogs
   258          * in aSelectedIndexes array.
   259          * (like progress note) are not affected. Returns user selected indices,
   259          * @param aSelectableItems - array of selectable items displayed
   260          * in aSelectedIndexes array (empty if cancelled).
       
   261          * @param aTitle - multi-selection dialog title
       
   262          * @param aSelectableItems - array of selectable items
       
   263          * @param aSelectedIndexes - returns the selected item indices
   260          * @param aSelectedIndexes - returns the selected item indices
   264          * @return TBool - ETrue if the user accepted the query, EFalse otherwise
   261          * @return TBool - ETrue if the user accepted the query, EFalse otherwise
   265          */
   262          */
   266         IMPORT_C TBool ShowMultiSelectionL( const TDesC& aTitle,
   263         IMPORT_C TBool ShowSelectOptionsL( const MDesCArray& aSelectableItems,
   267             const MDesCArray& aSelectableItems, RArray<TInt>& aSelectedIndexes );
   264                 RArray<TInt>& aSelectedIndexes );
   268 
   265 
   269 
   266 
   270         //=================================================
   267         //=================================================
   271         // DEPRECATED METHODS
   268         // DEPRECATED METHODS
   272         //=================================================
   269         //=================================================
   273 
   270 
   274         // DEPRECATED, WILL BE REMOVED, DO NOT USE
   271         // DEPRECATED, WILL BE REMOVED, DO NOT USE
   275         IMPORT_C void ShowFailedL( TInt aErrorCode, const TDesC& aErrorMessage,
   272         IMPORT_C void ShowFailedL( TInt aErrorCode, const TDesC& aErrorMessage,
   276             const TDesC& aErrorDetails = KNullDesC );
   273             const TDesC& aErrorDetails = KNullDesC );
       
   274         IMPORT_C TBool ShowSingleSelectionL( const TDesC& aTitle,
       
   275             const MDesCArray& aSelectableItems, TInt& aSelectedIndex );
       
   276         IMPORT_C TBool ShowMultiSelectionL( const TDesC& aTitle,
       
   277             const MDesCArray& aSelectableItems, RArray<TInt>& aSelectedIndexes );
   277 
   278 
   278 
   279 
   279     private:    // new functions
   280     private:    // new functions
   280         CSifUi();
   281         CSifUi();
   281         void ConstructL();
   282         void ConstructL();