test: epoc32/include/mw/akncommondialogs.h@2fe1408b6811

     1 /*

     2 * Copyright (c) 2002-2006 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".

8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Static class to call combined common file dialogs.

    15 *

    16 */

    19 #ifndef AKNCOMMONDIALOGS_H

    20 #define AKNCOMMONDIALOGS_H

    22 // INCLUDES

    23 #include <CAknCommonDialogsBase.h>

    25 // FORWARD DECLARATIONS

    26 class MAknMemorySelectionObserver;

    27 class MAknFileSelectionObserver;

    28 class MAknFileFilter;

    30 // CLASS DEFINITION

    31 /**

    32 *  DEPRECATED: Use AknCommonDialogsDynMem instead. This class is only used as a

    33 *  proxy to the new implementation class to maintain backwards compatibility.

    34 *

    35 *  A class that consists of static functions that launch UI components in a

    36 *  sequence. First, memory selection component is launched and then

    37 *  file/directory selection component. In save and move dialogs directory

    38 *  selection may not be shown if there are no subdirectories to choose from.

    39 *  In save dialog, finally filename prompt component is launched.

    40 *

    41 *  All methods have an obligatory resource ID parameter for memory selection

    42 *  because it contains the paths for both memories (Phone&MMC) (LOCATION structs).

    43 *  If set, an observer is queried just before exiting the dialog.

    44 *  At this point the application can either reject or accept user's selection.

    45 *  Every dialog returns a boolean value which tells if user has selected something

    46 *  or not.

    47 *

    48 *  @lib CommonDialogs.lib

    49 *  @since 1.2

    50 */

    51 class AknCommonDialogs

    52     {

    54     public:

    56         /**

    57          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

    58          *

    59          * A static method that launches file selection dialog.

    60          * @param aFileName Full path and filename of the file that user

    61          *        selects is stored to this descriptor.

    62          * @param aMemorySelectionResourceId A resource id for memory selection

    63          *        dialog.

    64          * @param aObserver An observer which is asked, if set, to verify user's

    65          *        selection.

    66          * @return Returns ETrue if user selects a file, otherwise EFalse.

    67          */

    68         IMPORT_C static TBool RunSelectDlgLD(

    69             TDes& aFileName,

    70             TInt aMemorySelectionResourceId,

    71             MAknFileSelectionObserver* aObserver = NULL );

    73         /**

    74          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

    75          *

    76          * A static method that launches file selection dialog.

    77          * @param aFileName Full path and filename of the file that user

    78          *        selects is stored to this descriptor.

    79          * @param aMemorySelectionResourceId A resource id for memory selection

    80          *        dialog.

    81          * @param aFilter Filter is asked if a directory entry can be shown in

    82          *        list. Ownership is not transferred.

    83          * @param aObserver An observer which is asked, if set, to verify user's

    84          *        selection.

    85          * @return Returns ETrue if user selects a file, otherwise EFalse.

    86          */

    87         IMPORT_C static TBool RunSelectDlgLD(

    88             TDes& aFileName,

    89             TInt aMemorySelectionResourceId,

    90             MAknFileFilter* aFilter,

    91             MAknFileSelectionObserver* aObserver = NULL );

    93         /**

    94          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

    95          *

    96          * A static method that launches file selection dialog.

    97          * @param aFileName Full path and filename of the file that user

    98          *        selects is stored to this descriptor.

    99          * @param aMemorySelectionResourceId A resource id for memory selection

   100          *        dialog.

   101          * @param aFileSelectionTitle A custom title for file selection dialog.

   102          * @param aObserver An observer which is asked, if set, to verify user's

   103          *        selection.

   104          * @return Returns ETrue if user selects a file, otherwise EFalse.

   105          */

   106         IMPORT_C static TBool RunSelectDlgLD(

   107             TDes& aFileName,

   108             TInt aMemorySelectionResourceId,

   109             const TDesC& aFileSelectionTitle,

   110             MAknFileSelectionObserver* aObserver = NULL );

   112         /**

   113          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

   114          *

   115          * A static method that launches file selection dialog.

   116          * @param aFileName Full path and filename of the file that user

   117          *        selects is stored to this descriptor.

   118          * @param aMemorySelectionResourceId A resource id for memory selection

   119          *        dialog.

   120          * @param aFileSelectionResourceId A resource id for file selection

   121          *        dialog.

   122          * @param aObserver An observer which is asked, if set, to verify user's

   123          *        selection.

   124          * @return Returns ETrue if user selects a file, otherwise EFalse.

   125          */

   126         IMPORT_C static TBool RunSelectDlgLD(

   127             TDes& aFileName,

   128             TInt aMemorySelectionResourceId,

   129             TInt aFileSelectionResourceId,

   130             MAknFileSelectionObserver* aObserver = NULL );

   132         /**

   133          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

   134          *

   135          * A static method that launches move dialog.

   136          * @param aDirectory Full path of the folder that user

   137          *        selects is stored to this descriptor.

   138          * @param aMemorySelectionResourceId A resource id for memory selection

   139          *        dialog.

   140          * @param aObserver An observer which is asked, if set, to verify user's

   141          *        selection.

   142          * @return Returns ETrue if user selects a folder, otherwise EFalse.

   143          */

   144         IMPORT_C static TBool RunMoveDlgLD(

   145             TDes& aDirectory,

   146             TInt aMemorySelectionResourceId,

   147             MAknFileSelectionObserver* aObserver = NULL );

   149         /**

   150          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

   151          *

   152          * A static method that launches move dialog.

   153          * @param aDirectory Full path of the folder that user

   154          *        selects is stored to this descriptor.

   155          * @param aMemorySelectionResourceId A resource id for memory selection

   156          *        dialog.

   157          * @param aFilter Filter is asked if a directory entry can be shown in

   158          *        list. Ownership is not transferred.

   159          * @param aObserver An observer which is asked, if set, to verify user's

   160          *        selection.

   161          * @return Returns ETrue if user selects a folder, otherwise EFalse.

   162          */

   163         IMPORT_C static TBool RunMoveDlgLD(

   164             TDes& aDirectory,

   165             TInt aMemorySelectionResourceId,

   166             MAknFileFilter* aFilter,

   167             MAknFileSelectionObserver* aObserver = NULL );

   169         /**

   170          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

   171          *

   172          * A static method that launches move dialog.

   173          * @param aDirectory Full path of the folder that user

   174          *        selects is stored to this descriptor.

   175          * @param aMemorySelectionResourceId A resource id for memory selection

   176          *        dialog.

   177          * @param aFileSelectionTitle A custom title for directory selection

   178          *        dialog.

   179          * @param aObserver An observer which is asked, if set, to verify user's

   180          *        selection.

   181          * @return Returns ETrue if user selects a folder, otherwise EFalse

   182          */

   183         IMPORT_C static TBool RunMoveDlgLD(

   184             TDes& aDirectory,

   185             TInt aMemorySelectionResourceId,

   186             const TDesC& aFileSelectionTitle,

   187             MAknFileSelectionObserver* aObserver = NULL );

   189         /**

   190          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

   191          *

   192          * A static method that launches move dialog.

   193          * @param aDirectory Full path of the folder that user

   194          *        selects is stored to this descriptor.

   195          * @param aMemorySelectionResourceId A resource id for memory selection

   196          *        dialog

   197          * @param aFileSelectionResourceId A resource id for file selection

   198          *        dialog

   199          * @param aObserver An observer which is asked, if set, to verify user's

   200          *        selection.

   201          * @return Returns ETrue if user selects a folder, otherwise EFalse

   202          */

   203         IMPORT_C static TBool RunMoveDlgLD(

   204             TDes& aDirectory,

   205             TInt aMemorySelectionResourceId,

   206             TInt aFileSelectionResourceId,

   207             MAknFileSelectionObserver* aObserver = NULL );

   209         /**

   210          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

   211          *

   212          * A static method that launches save dialog which does not run folder

   213          * selection dialog at all. Instead the resulting path will be

   214          * constructed from the root and default folder read from resources and

   215          * from the file name given by the user.

   216          * @param aDefaultFileName Full path + the filename that user enters

   217          *        is stored to this descriptor. The descriptor may contain text

   218          *        that is used as default filename, for example "Attachment".

   219          * @param aMemorySelectionResourceId A resource id for memory selection

   220          *        dialog.

   221          * @param aObserver An observer which is asked, if set, to verify the

   222          *        filename that user types.

   223          * @return Returns ETrue if user accepts or enters a filename, otherwise

   224          *         EFalse.

   225          */

   226          IMPORT_C static TBool RunSaveDlgLD(

   227             TDes& aDefaultFileName,

   228             TInt aMemorySelectionResourceId,

   229             MAknFileSelectionObserver* aObserver = NULL );

   231         /**

   232          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

   233          *

   234          * A static method that launches save dialog.

   235          * @param aDefaultFileName Full path + the filename that user enters

   236          *        is stored to this descriptor. The descriptor may contain text

   237          *        that is used as default filename, for example "Attachment".

   238          * @param aMemorySelectionResourceId A resource id for memory selection

   239          *        dialog.

   240          * @param aFilter Filter is asked if a directory entry can be shown in

   241          *        list. Ownership is not transferred.

   242          * @param aObserver An observer which is asked, if set, to verify the

   243          *        filename that user types.

   244          * @return Returns ETrue if user accepts or enters a filename, otherwise

   245          *         EFalse.

   246          */

   247          IMPORT_C static TBool RunSaveDlgLD(

   248             TDes& aDefaultFileName,

   249             TInt aMemorySelectionResourceId,

   250             MAknFileFilter* aFilter,

   251             MAknFileSelectionObserver* aObserver = NULL );

   253         /**

   254          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

   255          *

   256          * A static method that launches save dialog.

   257          * @param aDefaultFileName Full path + the filename that user enters

   258          *        is stored to this descriptor. The descriptor may contain text

   259          *        that is used as default filename, for example "Attachment".

   260          * @param aMemorySelectionResourceId A resource id for memory selection

   261          *        dialog.

   262          * @param aFileSelectionTitle Custom title for file selection dialog.

   263          * @param aFileNamePromptTitle Custom title for filename prompt dialog.

   264          * @param aObserver An observer which is asked, if set, to verify the

   265          *        filename that user types.

   266          * @return Returns ETrue if user accepts or enters a filename, otherwise

   267          *         EFalse.

   268          */

   269         IMPORT_C static TBool RunSaveDlgLD(

   270             TDes& aDefaultFileName,

   271             TInt aMemorySelectionResourceId,

   272             const TDesC& aFileSelectionTitle,

   273             const TDesC& aFileNamePromptTitle,

   274             MAknFileSelectionObserver* aObserver = NULL );

   276         /**

   277          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

   278          *

   279          * A static method that launches save dialog.

   280          * @param aDefaultFileName Full path + the filename that user enters

   281          *        is stored to this descriptor. The descriptor may contain text

   282          *        that is used as default filename, for example "Attachment".

   283          * @param aMemorySelectionResourceId A resource id for memory selection

   284          *        dialog.

   285          * @param aFileSelectionResourceId A resource id for file selection

   286          *        dialog.

   287          * @param aObserver An observer which is asked, if set, to verify the

   288          *        filename that user types.

   289          * @return Returns ETrue if user accepts or enters a filename, otherwise

   290          *         EFalse.

   291          */

   292          IMPORT_C static TBool RunSaveDlgLD(

   293             TDes& aDefaultFileName,

   294             TInt aMemorySelectionResourceId,

   295             TInt aFileSelectionResourceId,

   296             MAknFileSelectionObserver* aObserver = NULL );

   298         /**

   299          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

   300          *

   301          * A static method that launches save dialog.

   302          * @param aDefaultFileName Full path + the filename that user enters

   303          *        is stored to this descriptor. The descriptor may contain text

   304          *        that is used as default filename, for example "Attachment".

   305          * @param aMemorySelectionResourceId A resource id for memory selection

   306          *        dialog.

   307          * @param aFileSelectionResourceId A resource id for file selection

   308          *        dialog.

   309          * @param aFileNamePromptTitle Custom title for filename prompt dialog.

   310          * @param aObserver An observer which is asked, if set, to verify the

   311          *        filename that user types.

   312          * @return Returns ETrue if user accepts or enters a filename, otherwise

   313          *         EFalse.

   314          */

   315          IMPORT_C static TBool RunSaveDlgLD(

   316             TDes& aDefaultFileName,

   317             TInt aMemorySelectionResourceId,

   318             TInt aFileSelectionResourceId,

   319             const TDesC& aFileNamePromptTitle,

   320             MAknFileSelectionObserver* aObserver = NULL );

   322          /**

   323          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

   324          *

   325          * A static method that launches save dialog. No file selection dialog

   326          * for directory selection is displayed.

   327          * @param aDefaultFileName Full path + the filename that user enters

   328          *        is stored to this descriptor. The descriptor may contain text

   329          *        that is used as default filename, for example "Attachment".

   330          * @param aMemorySelectionResourceId A resource id for memory selection

   331          *        dialog. The folders in which the file will be saved should be

   332          *        given in this resource.

   333          * @param aObserver An observer which is asked, if set, to verify the

   334          *        filename that user types.

   335          * @return Returns ETrue if user accepts or enters a filename, otherwise

   336          *         EFalse.

   337          */

   338          IMPORT_C static TBool RunSaveDlgNoDirectorySelectionLD(

   339             TDes& aDefaultFileName,

   340             TInt aMemorySelectionResourceId,

   341             MAknFileSelectionObserver* aObserver = NULL );

   343          /**

   344          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

   345          *

   346          * A static method that launches save dialog. No file selection dialog

   347          * for directory selection is displayed.

   348          * @param aDefaultFileName Full path + the filename that user enters

   349          *        is stored to this descriptor. The descriptor may contain text

   350          *        that is used as default filename, for example "Attachment".

   351          * @param aMemorySelectionResourceId A resource id for memory selection

   352          *        dialog. The folders in which the file will be saved should be

   353          *        given in this resource.

   354          * @param aFileNamePromptTitle Custom title for filename prompt dialog.

   355          * @param aObserver An observer which is asked, if set, to verify the

   356          *        filename that user types.

   357          * @return Returns ETrue if user accepts or enters a filename, otherwise

   358          *         EFalse.

   359          */

   360          IMPORT_C static TBool RunSaveDlgNoDirectorySelectionLD(

   361             TDes& aDefaultFileName,

   362             TInt aMemorySelectionResourceId,

   363             const TDesC& aFileNamePromptTitle,

   364             MAknFileSelectionObserver* aObserver = NULL );

   366         /**

   367          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

   368          *

   369          * A static method that launches copy dialog.

   370          * @param aDirectory Full path of the folder that user

   371          *        selects is stored to this descriptor.

   372          * @param aMemorySelectionResourceId A resource id for memory selection

   373          *        dialog.

   374          * @param aObserver An observer which is asked, if set, to verify user's

   375          *        selection.

   376          * @return Returns ETrue if user selects a folder, otherwise EFalse.

   377          */

   378         IMPORT_C static TBool RunCopyDlgLD(

   379             TDes& aDirectory,

   380             TInt aMemorySelectionResourceId,

   381             MAknFileSelectionObserver* aObserver = NULL );

   383         /**

   384          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

   385          *

   386          * A static method that launches copy dialog.

   387          * @param aDirectory Full path of the folder that user

   388          *        selects is stored to this descriptor.

   389          * @param aMemorySelectionResourceId A resource id for memory selection

   390          *        dialog.

   391          * @param aFilter Filter is asked if a directory entry can be shown in

   392          *        list. Ownership is not transferred.

   393          * @param aObserver An observer which is asked, if set, to verify user's

   394          *        selection.

   395          * @return Returns ETrue if user selects a folder, otherwise EFalse.

   396          */

   397         IMPORT_C static TBool RunCopyDlgLD(

   398             TDes& aDirectory,

   399             TInt aMemorySelectionResourceId,

   400             MAknFileFilter* aFilter,

   401             MAknFileSelectionObserver* aObserver = NULL );

   403         /**

   404          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

   405          *

   406          * A static method that launches copy dialog.

   407          * @param aDirectory Full path of the folder that user

   408          *        selects is stored to this descriptor.

   409          * @param aMemorySelectionResourceId A resource id for memory selection

   410          *        dialog

   411          * @param aFileSelectionResourceId A resource id for file selection

   412          *        dialog

   413          * @param aObserver An observer which is asked, if set, to verify user's

   414          *        selection.

   415          * @return Returns ETrue if user selects a folder, otherwise EFalse

   416          */

   417         IMPORT_C static TBool RunCopyDlgLD(

   418             TDes& aDirectory,

   419             TInt aMemorySelectionResourceId,

   420             TInt aFileSelectionResourceId,

   421             MAknFileSelectionObserver* aObserver = NULL );

   423         /**

   424          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

   425          *

   426         * A static method that launches file selection dialog.

   427         * @param aFileName Full path and filename of the file that user

   428         *        selects is stored to this descriptor.

   429         * @param aStartFolder User defined folder to start browsing in file selection

   430         * @param aMemorySelectionResourceId A resource id for memory selection

   431         *        dialog.

   432         * @param aObserver An observer which is asked, if set, to verify user's

   433         *        selection.

   434         * @return Returns ETrue if user selects a file, otherwise EFalse.

   435         * @since 2.6

   436         */

   437         IMPORT_C static TBool RunSelectDlgLD(

   438             TDes& aFileName,

   439             const TDesC& aStartFolder,

   440             TInt aMemorySelectionResourceId,

   441             MAknFileSelectionObserver* aObserver = NULL );

   443         /**

   444          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

   445          *

   446          * A static method that launches file selection dialog.

   447          * @param aFileName Full path and filename of the file that user

   448          *        selects is stored to this descriptor.

   449          * @param aStartFolder User defined folder to start browsing in file selection

   450          * @param aMemorySelectionResourceId A resource id for memory selection

   451          *        dialog.

   452          * @param aFilter Filter is asked if a directory entry can be shown in

   453          *        list. Ownership is not transferred.

   454          * @param aObserver An observer which is asked, if set, to verify user's

   455          *        selection.

   456          * @return Returns ETrue if user selects a file, otherwise EFalse.

   457          * @since 2.6

   458          */

   459         IMPORT_C static TBool RunSelectDlgLD(

   460             TDes& aFileName,

   461             const TDesC& aStartFolder,

   462             TInt aMemorySelectionResourceId,

   463             MAknFileFilter* aFilter,

   464             MAknFileSelectionObserver* aObserver = NULL );

   466         /**

   467          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

   468          *

   469          * A static method that launches file selection dialog.

   470          * @param aFileName Full path and filename of the file that user

   471          *        selects is stored to this descriptor.

   472          * @param aStartFolder User defined folder to start browsing in file selection

   473          * @param aMemorySelectionResourceId A resource id for memory selection

   474          *        dialog.

   475          * @param aFileSelectionTitle A custom title for file selection dialog.

   476          * @param aObserver An observer which is asked, if set, to verify user's

   477          *        selection.

   478          * @return Returns ETrue if user selects a file, otherwise EFalse.

   479          * @since 2.6

   480          */

   481         IMPORT_C static TBool RunSelectDlgLD(

   482             TDes& aFileName,

   483             const TDesC& aStartFolder,

   484             TInt aMemorySelectionResourceId,

   485             const TDesC& aFileSelectionTitle,

   486             MAknFileSelectionObserver* aObserver = NULL );

   488         /**

   489          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

   490          *

   491          * A static method that launches file selection dialog.

   492          * @param aFileName Full path and filename of the file that user

   493          *        selects is stored to this descriptor.

   494          * @param aStartFolder User defined folder to start browsing in file selection

   495          * @param aMemorySelectionResourceId A resource id for memory selection

   496          *        dialog.

   497          * @param aFileSelectionResourceId A resource id for file selection

   498          *        dialog.

   499          * @param aObserver An observer which is asked, if set, to verify user's

   500          *        selection.

   501          * @return Returns ETrue if user selects a file, otherwise EFalse.

   502          * @since 2.6

   503          */

   504         IMPORT_C static TBool RunSelectDlgLD(

   505             TDes& aFileName,

   506             const TDesC& aStartFolder,

   507             TInt aMemorySelectionResourceId,

   508             TInt aFileSelectionResourceId,

   509             MAknFileSelectionObserver* aObserver = NULL );

   511         /**

   512          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

   513          *

   514          * A static method that launches file selection dialog.

   515          * @param aFileName Full path and filename of the file that user selects is

   516          *        stored to this descriptor.

   517          * @param aStartFolder User defined folder to start browsing in file selection.

   518          * @param aMemorySelectionResourceId A resource id for memory selection dialog.

   519          * @param aFileSelectionResourceId A resource id for file selection dialog.

   520          * @param aFileSelectionTitle Custom title for file selection dialog.

   521          * @param aFilter Filter asked if a directory entry can be shown in list.

   522          * @param aObserver An observer which is asked to verify user's selection.

   523          * @return Returns ETrue if user selects a file, otherwise EFalse

   524          * @since 3.1

   525          */

   526         IMPORT_C static TBool RunSelectDlgLD(

   527             TDes& aFileName,

   528             const TDesC& aStartFolder,

   529             TInt aMemorySelectionResourceId,

   530             TInt aFileSelectionResourceId,

   531             const TDesC& aFileSelectionTitle,

   532             MAknFileFilter* aFilter = NULL,

   533             MAknFileSelectionObserver* aObserver = NULL );

   535         /**

   536          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

   537          *

   538          * A static method that launches save dialog.

   539          * @param aDefaultFileName Full path + the filename that user enters

   540          *        is stored to this descriptor. The descriptor may contain text

   541          *        that is used as default filename, for example "Attachment".

   542          * @param aStartFolder User defined folder to start browsing in file selection.

   543          * @param aMemorySelectionResourceId A resource id for memory selection dialog.

   544          * @param aFileSelectionResourceId A resource id for file selection dialog.

   545          * @param aFileSelectionTitle Custom title for file selection dialog.

   546          * @param aFilter Filter asked if a directory entry can be shown in list.

   547          * @param aObserver An observer which is asked, if set, to verify the

   548          *        filename that user types.

   549          * @return Returns ETrue if user accepts or enters a filename, otherwise

   550          *         EFalse.

   551          * @since 3.1

   552          */

   553         IMPORT_C static TBool RunSaveDlgLD(

   554             TDes& aDefaultFileName,

   555             const TDesC& aStartFolder,

   556             TInt aMemorySelectionResourceId,

   557             TInt aFileSelectionResourceId,

   558             const TDesC& aFileSelectionTitle,

   559             MAknFileFilter* aFilter = NULL,

   560             MAknFileSelectionObserver* aObserver = NULL );

   562         /**

   563          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.

   564          *

   565          * A static method that launches folder selection dialog.

   566          * @param aFolder Full path of the folder that user selects is stored to this

   567          *        descriptor.

   568          * @param aStartFolder User defined folder to start browsing in file selection.

   569          * @param aMemorySelectionResourceId A resource id for memory selection dialog.

   570          * @param aFileSelectionResourceId A resource id for file selection dialog.

   571          * @param aFileSelectionTitle Custom title for file selection dialog.

   572          * @param aFilter Filter is asked if a directory entry can be shown in list.

   573          * @param aObserver An observer which is asked to verify user's selection.

   574          * @return Returns ETrue if user selects a folder, otherwise EFalse

   575          * @since 3.1

   576          */

   577         IMPORT_C static TBool RunFolderSelectDlgLD(

   578             TDes& aFolder,

   579             const TDesC& aStartFolder,

   580             TInt aMemorySelectionResourceId,

   581             TInt aFileSelectionResourceId,

   582             const TDesC& aFileSelectionTitle,

   583             MAknFileFilter* aFilter = NULL,

   584             MAknFileSelectionObserver* aObserver = NULL );

   586     };

   588 #endif // AKNCOMMONDIALOGS_H

   590 // End of File

author	William Roberts <williamr@symbian.org>
	Tue, 16 Mar 2010 16:12:26 +0000
branch	Symbian2
changeset 2	2fe1408b6811
parent 1	666f914201fb
child 4	837f303aceeb
permissions	-rw-r--r--