williamr@2: /*
williamr@2: * Copyright (c) 2002-2006 Nokia Corporation and/or its subsidiary(-ies).
williamr@2: * All rights reserved.
williamr@2: * This component and the accompanying materials are made available
williamr@2: * 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
williamr@2: * which accompanies this distribution, and is available
williamr@2: * at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
williamr@2: *
williamr@2: * Initial Contributors:
williamr@2: * Nokia Corporation - initial contribution.
williamr@2: *
williamr@2: * Contributors:
williamr@2: *
williamr@2: * Description:  Static class to call combined common file dialogs.
williamr@2: *
williamr@2: */
williamr@2: 
williamr@2: 
williamr@2: #ifndef AKNCOMMONDIALOGS_H
williamr@2: #define AKNCOMMONDIALOGS_H
williamr@2: 
williamr@2: // INCLUDES
williamr@2: #include <CAknCommonDialogsBase.h>
williamr@2: 
williamr@2: // FORWARD DECLARATIONS
williamr@2: class MAknMemorySelectionObserver;
williamr@2: class MAknFileSelectionObserver;
williamr@2: class MAknFileFilter;
williamr@2: 
williamr@2: // CLASS DEFINITION
williamr@2: /**
williamr@2: *  DEPRECATED: Use AknCommonDialogsDynMem instead. This class is only used as a
williamr@2: *  proxy to the new implementation class to maintain backwards compatibility.
williamr@2: *
williamr@2: *  A class that consists of static functions that launch UI components in a
williamr@2: *  sequence. First, memory selection component is launched and then
williamr@2: *  file/directory selection component. In save and move dialogs directory
williamr@2: *  selection may not be shown if there are no subdirectories to choose from.
williamr@2: *  In save dialog, finally filename prompt component is launched.
williamr@2: *
williamr@2: *  All methods have an obligatory resource ID parameter for memory selection
williamr@2: *  because it contains the paths for both memories (Phone&MMC) (LOCATION structs).
williamr@2: *  If set, an observer is queried just before exiting the dialog.
williamr@2: *  At this point the application can either reject or accept user's selection.
williamr@2: *  Every dialog returns a boolean value which tells if user has selected something
williamr@2: *  or not.
williamr@2: *
williamr@2: *  @lib CommonDialogs.lib
williamr@2: *  @since 1.2
williamr@2: */
williamr@2: class AknCommonDialogs
williamr@2:     {
williamr@2:     
williamr@2:     public:
williamr@2:   
williamr@2:         /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches file selection dialog.
williamr@2:          * @param aFileName Full path and filename of the file that user
williamr@2:          *        selects is stored to this descriptor.
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection
williamr@2:          *        dialog.
williamr@2:          * @param aObserver An observer which is asked, if set, to verify user's
williamr@2:          *        selection.
williamr@2:          * @return Returns ETrue if user selects a file, otherwise EFalse.
williamr@2:          */
williamr@2:         IMPORT_C static TBool RunSelectDlgLD(
williamr@2:             TDes& aFileName,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2: 
williamr@2:         /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches file selection dialog.
williamr@2:          * @param aFileName Full path and filename of the file that user
williamr@2:          *        selects is stored to this descriptor.
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection
williamr@2:          *        dialog.
williamr@2:          * @param aFilter Filter is asked if a directory entry can be shown in
williamr@2:          *        list. Ownership is not transferred.
williamr@2:          * @param aObserver An observer which is asked, if set, to verify user's
williamr@2:          *        selection.
williamr@2:          * @return Returns ETrue if user selects a file, otherwise EFalse.
williamr@2:          */
williamr@2:         IMPORT_C static TBool RunSelectDlgLD(
williamr@2:             TDes& aFileName,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             MAknFileFilter* aFilter,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2: 
williamr@2:         /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches file selection dialog.
williamr@2:          * @param aFileName Full path and filename of the file that user
williamr@2:          *        selects is stored to this descriptor.
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection
williamr@2:          *        dialog.
williamr@2:          * @param aFileSelectionTitle A custom title for file selection dialog.
williamr@2:          * @param aObserver An observer which is asked, if set, to verify user's
williamr@2:          *        selection.
williamr@2:          * @return Returns ETrue if user selects a file, otherwise EFalse.
williamr@2:          */
williamr@2:         IMPORT_C static TBool RunSelectDlgLD(
williamr@2:             TDes& aFileName,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             const TDesC& aFileSelectionTitle,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2: 
williamr@2:         /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches file selection dialog.
williamr@2:          * @param aFileName Full path and filename of the file that user
williamr@2:          *        selects is stored to this descriptor.
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection
williamr@2:          *        dialog.
williamr@2:          * @param aFileSelectionResourceId A resource id for file selection
williamr@2:          *        dialog.
williamr@2:          * @param aObserver An observer which is asked, if set, to verify user's
williamr@2:          *        selection.
williamr@2:          * @return Returns ETrue if user selects a file, otherwise EFalse.
williamr@2:          */
williamr@2:         IMPORT_C static TBool RunSelectDlgLD(
williamr@2:             TDes& aFileName,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             TInt aFileSelectionResourceId,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2: 
williamr@2:         /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches move dialog.
williamr@2:          * @param aDirectory Full path of the folder that user
williamr@2:          *        selects is stored to this descriptor.
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection
williamr@2:          *        dialog.
williamr@2:          * @param aObserver An observer which is asked, if set, to verify user's
williamr@2:          *        selection.
williamr@2:          * @return Returns ETrue if user selects a folder, otherwise EFalse.
williamr@2:          */
williamr@2:         IMPORT_C static TBool RunMoveDlgLD(
williamr@2:             TDes& aDirectory,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2: 
williamr@2:         /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches move dialog.
williamr@2:          * @param aDirectory Full path of the folder that user
williamr@2:          *        selects is stored to this descriptor.
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection
williamr@2:          *        dialog.
williamr@2:          * @param aFilter Filter is asked if a directory entry can be shown in
williamr@2:          *        list. Ownership is not transferred.
williamr@2:          * @param aObserver An observer which is asked, if set, to verify user's
williamr@2:          *        selection.
williamr@2:          * @return Returns ETrue if user selects a folder, otherwise EFalse.
williamr@2:          */
williamr@2:         IMPORT_C static TBool RunMoveDlgLD(
williamr@2:             TDes& aDirectory,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             MAknFileFilter* aFilter,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2: 
williamr@2:         /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches move dialog.
williamr@2:          * @param aDirectory Full path of the folder that user
williamr@2:          *        selects is stored to this descriptor.
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection
williamr@2:          *        dialog.
williamr@2:          * @param aFileSelectionTitle A custom title for directory selection
williamr@2:          *        dialog.
williamr@2:          * @param aObserver An observer which is asked, if set, to verify user's
williamr@2:          *        selection.
williamr@2:          * @return Returns ETrue if user selects a folder, otherwise EFalse
williamr@2:          */
williamr@2:         IMPORT_C static TBool RunMoveDlgLD(
williamr@2:             TDes& aDirectory,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             const TDesC& aFileSelectionTitle,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2: 
williamr@2:         /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches move dialog.
williamr@2:          * @param aDirectory Full path of the folder that user
williamr@2:          *        selects is stored to this descriptor.
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection
williamr@2:          *        dialog
williamr@2:          * @param aFileSelectionResourceId A resource id for file selection
williamr@2:          *        dialog
williamr@2:          * @param aObserver An observer which is asked, if set, to verify user's
williamr@2:          *        selection.
williamr@2:          * @return Returns ETrue if user selects a folder, otherwise EFalse
williamr@2:          */
williamr@2:         IMPORT_C static TBool RunMoveDlgLD(
williamr@2:             TDes& aDirectory,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             TInt aFileSelectionResourceId,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2: 
williamr@2:         /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches save dialog which does not run folder
williamr@2:          * selection dialog at all. Instead the resulting path will be
williamr@2:          * constructed from the root and default folder read from resources and
williamr@2:          * from the file name given by the user.
williamr@2:          * @param aDefaultFileName Full path + the filename that user enters
williamr@2:          *        is stored to this descriptor. The descriptor may contain text
williamr@2:          *        that is used as default filename, for example "Attachment".
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection
williamr@2:          *        dialog.
williamr@2:          * @param aObserver An observer which is asked, if set, to verify the
williamr@2:          *        filename that user types.
williamr@2:          * @return Returns ETrue if user accepts or enters a filename, otherwise
williamr@2:          *         EFalse.
williamr@2:          */
williamr@2:          IMPORT_C static TBool RunSaveDlgLD(
williamr@2:             TDes& aDefaultFileName,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2: 
williamr@2:         /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches save dialog.
williamr@2:          * @param aDefaultFileName Full path + the filename that user enters
williamr@2:          *        is stored to this descriptor. The descriptor may contain text
williamr@2:          *        that is used as default filename, for example "Attachment".
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection
williamr@2:          *        dialog.
williamr@2:          * @param aFilter Filter is asked if a directory entry can be shown in
williamr@2:          *        list. Ownership is not transferred.
williamr@2:          * @param aObserver An observer which is asked, if set, to verify the
williamr@2:          *        filename that user types.
williamr@2:          * @return Returns ETrue if user accepts or enters a filename, otherwise
williamr@2:          *         EFalse.
williamr@2:          */
williamr@2:          IMPORT_C static TBool RunSaveDlgLD(
williamr@2:             TDes& aDefaultFileName,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             MAknFileFilter* aFilter,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2: 
williamr@2:         /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches save dialog.
williamr@2:          * @param aDefaultFileName Full path + the filename that user enters
williamr@2:          *        is stored to this descriptor. The descriptor may contain text
williamr@2:          *        that is used as default filename, for example "Attachment".
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection
williamr@2:          *        dialog.
williamr@2:          * @param aFileSelectionTitle Custom title for file selection dialog.
williamr@2:          * @param aFileNamePromptTitle Custom title for filename prompt dialog.
williamr@2:          * @param aObserver An observer which is asked, if set, to verify the
williamr@2:          *        filename that user types.
williamr@2:          * @return Returns ETrue if user accepts or enters a filename, otherwise
williamr@2:          *         EFalse.
williamr@2:          */
williamr@2:         IMPORT_C static TBool RunSaveDlgLD(
williamr@2:             TDes& aDefaultFileName,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             const TDesC& aFileSelectionTitle,
williamr@2:             const TDesC& aFileNamePromptTitle,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2: 
williamr@2:         /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches save dialog.
williamr@2:          * @param aDefaultFileName Full path + the filename that user enters
williamr@2:          *        is stored to this descriptor. The descriptor may contain text
williamr@2:          *        that is used as default filename, for example "Attachment".
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection
williamr@2:          *        dialog.
williamr@2:          * @param aFileSelectionResourceId A resource id for file selection
williamr@2:          *        dialog.
williamr@2:          * @param aObserver An observer which is asked, if set, to verify the
williamr@2:          *        filename that user types.
williamr@2:          * @return Returns ETrue if user accepts or enters a filename, otherwise
williamr@2:          *         EFalse.
williamr@2:          */
williamr@2:          IMPORT_C static TBool RunSaveDlgLD(
williamr@2:             TDes& aDefaultFileName,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             TInt aFileSelectionResourceId,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2: 
williamr@2:         /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches save dialog.
williamr@2:          * @param aDefaultFileName Full path + the filename that user enters
williamr@2:          *        is stored to this descriptor. The descriptor may contain text
williamr@2:          *        that is used as default filename, for example "Attachment".
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection
williamr@2:          *        dialog.
williamr@2:          * @param aFileSelectionResourceId A resource id for file selection
williamr@2:          *        dialog.
williamr@2:          * @param aFileNamePromptTitle Custom title for filename prompt dialog.
williamr@2:          * @param aObserver An observer which is asked, if set, to verify the
williamr@2:          *        filename that user types.
williamr@2:          * @return Returns ETrue if user accepts or enters a filename, otherwise
williamr@2:          *         EFalse.
williamr@2:          */
williamr@2:          IMPORT_C static TBool RunSaveDlgLD(
williamr@2:             TDes& aDefaultFileName,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             TInt aFileSelectionResourceId,
williamr@2:             const TDesC& aFileNamePromptTitle,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2: 
williamr@2:          /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches save dialog. No file selection dialog
williamr@2:          * for directory selection is displayed.
williamr@2:          * @param aDefaultFileName Full path + the filename that user enters
williamr@2:          *        is stored to this descriptor. The descriptor may contain text
williamr@2:          *        that is used as default filename, for example "Attachment".
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection
williamr@2:          *        dialog. The folders in which the file will be saved should be
williamr@2:          *        given in this resource.
williamr@2:          * @param aObserver An observer which is asked, if set, to verify the
williamr@2:          *        filename that user types.
williamr@2:          * @return Returns ETrue if user accepts or enters a filename, otherwise
williamr@2:          *         EFalse.
williamr@2:          */
williamr@2:          IMPORT_C static TBool RunSaveDlgNoDirectorySelectionLD(
williamr@2:             TDes& aDefaultFileName,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2: 
williamr@2:          /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches save dialog. No file selection dialog
williamr@2:          * for directory selection is displayed.
williamr@2:          * @param aDefaultFileName Full path + the filename that user enters
williamr@2:          *        is stored to this descriptor. The descriptor may contain text
williamr@2:          *        that is used as default filename, for example "Attachment".
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection
williamr@2:          *        dialog. The folders in which the file will be saved should be
williamr@2:          *        given in this resource.
williamr@2:          * @param aFileNamePromptTitle Custom title for filename prompt dialog.
williamr@2:          * @param aObserver An observer which is asked, if set, to verify the
williamr@2:          *        filename that user types.
williamr@2:          * @return Returns ETrue if user accepts or enters a filename, otherwise
williamr@2:          *         EFalse.
williamr@2:          */
williamr@2:          IMPORT_C static TBool RunSaveDlgNoDirectorySelectionLD(
williamr@2:             TDes& aDefaultFileName,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             const TDesC& aFileNamePromptTitle,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2: 
williamr@2:         /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches copy dialog.
williamr@2:          * @param aDirectory Full path of the folder that user
williamr@2:          *        selects is stored to this descriptor.
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection
williamr@2:          *        dialog.
williamr@2:          * @param aObserver An observer which is asked, if set, to verify user's
williamr@2:          *        selection.
williamr@2:          * @return Returns ETrue if user selects a folder, otherwise EFalse.
williamr@2:          */
williamr@2:         IMPORT_C static TBool RunCopyDlgLD(
williamr@2:             TDes& aDirectory,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2:         
williamr@2:         /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches copy dialog.
williamr@2:          * @param aDirectory Full path of the folder that user
williamr@2:          *        selects is stored to this descriptor.
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection
williamr@2:          *        dialog.
williamr@2:          * @param aFilter Filter is asked if a directory entry can be shown in
williamr@2:          *        list. Ownership is not transferred.
williamr@2:          * @param aObserver An observer which is asked, if set, to verify user's
williamr@2:          *        selection.
williamr@2:          * @return Returns ETrue if user selects a folder, otherwise EFalse.
williamr@2:          */
williamr@2:         IMPORT_C static TBool RunCopyDlgLD(
williamr@2:             TDes& aDirectory,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             MAknFileFilter* aFilter,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2: 
williamr@2:         /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches copy dialog.
williamr@2:          * @param aDirectory Full path of the folder that user
williamr@2:          *        selects is stored to this descriptor.
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection
williamr@2:          *        dialog
williamr@2:          * @param aFileSelectionResourceId A resource id for file selection
williamr@2:          *        dialog
williamr@2:          * @param aObserver An observer which is asked, if set, to verify user's
williamr@2:          *        selection.
williamr@2:          * @return Returns ETrue if user selects a folder, otherwise EFalse
williamr@2:          */
williamr@2:         IMPORT_C static TBool RunCopyDlgLD(
williamr@2:             TDes& aDirectory,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             TInt aFileSelectionResourceId,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2: 
williamr@2:         /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:         * A static method that launches file selection dialog.
williamr@2:         * @param aFileName Full path and filename of the file that user
williamr@2:         *        selects is stored to this descriptor.
williamr@2:         * @param aStartFolder User defined folder to start browsing in file selection
williamr@2:         * @param aMemorySelectionResourceId A resource id for memory selection
williamr@2:         *        dialog.
williamr@2:         * @param aObserver An observer which is asked, if set, to verify user's
williamr@2:         *        selection.
williamr@2:         * @return Returns ETrue if user selects a file, otherwise EFalse.
williamr@2:         * @since 2.6
williamr@2:         */
williamr@2:         IMPORT_C static TBool RunSelectDlgLD(
williamr@2:             TDes& aFileName,
williamr@2:             const TDesC& aStartFolder,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2: 
williamr@2:         /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches file selection dialog.
williamr@2:          * @param aFileName Full path and filename of the file that user
williamr@2:          *        selects is stored to this descriptor.
williamr@2:          * @param aStartFolder User defined folder to start browsing in file selection
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection
williamr@2:          *        dialog.
williamr@2:          * @param aFilter Filter is asked if a directory entry can be shown in
williamr@2:          *        list. Ownership is not transferred.
williamr@2:          * @param aObserver An observer which is asked, if set, to verify user's
williamr@2:          *        selection.
williamr@2:          * @return Returns ETrue if user selects a file, otherwise EFalse.
williamr@2:          * @since 2.6
williamr@2:          */
williamr@2:         IMPORT_C static TBool RunSelectDlgLD(
williamr@2:             TDes& aFileName,
williamr@2:             const TDesC& aStartFolder,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             MAknFileFilter* aFilter,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2: 
williamr@2:         /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches file selection dialog.
williamr@2:          * @param aFileName Full path and filename of the file that user
williamr@2:          *        selects is stored to this descriptor.
williamr@2:          * @param aStartFolder User defined folder to start browsing in file selection
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection
williamr@2:          *        dialog.
williamr@2:          * @param aFileSelectionTitle A custom title for file selection dialog.
williamr@2:          * @param aObserver An observer which is asked, if set, to verify user's
williamr@2:          *        selection.
williamr@2:          * @return Returns ETrue if user selects a file, otherwise EFalse.
williamr@2:          * @since 2.6
williamr@2:          */
williamr@2:         IMPORT_C static TBool RunSelectDlgLD(
williamr@2:             TDes& aFileName,
williamr@2:             const TDesC& aStartFolder,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             const TDesC& aFileSelectionTitle,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2: 
williamr@2:         /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches file selection dialog.
williamr@2:          * @param aFileName Full path and filename of the file that user
williamr@2:          *        selects is stored to this descriptor.
williamr@2:          * @param aStartFolder User defined folder to start browsing in file selection
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection
williamr@2:          *        dialog.
williamr@2:          * @param aFileSelectionResourceId A resource id for file selection
williamr@2:          *        dialog.
williamr@2:          * @param aObserver An observer which is asked, if set, to verify user's
williamr@2:          *        selection.
williamr@2:          * @return Returns ETrue if user selects a file, otherwise EFalse.
williamr@2:          * @since 2.6
williamr@2:          */
williamr@2:         IMPORT_C static TBool RunSelectDlgLD(
williamr@2:             TDes& aFileName,
williamr@2:             const TDesC& aStartFolder,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             TInt aFileSelectionResourceId,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2:             
williamr@2:         /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches file selection dialog.
williamr@2:          * @param aFileName Full path and filename of the file that user selects is
williamr@2:          *        stored to this descriptor.
williamr@2:          * @param aStartFolder User defined folder to start browsing in file selection.
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection dialog.
williamr@2:          * @param aFileSelectionResourceId A resource id for file selection dialog.
williamr@2:          * @param aFileSelectionTitle Custom title for file selection dialog.
williamr@2:          * @param aFilter Filter asked if a directory entry can be shown in list.
williamr@2:          * @param aObserver An observer which is asked to verify user's selection.
williamr@2:          * @return Returns ETrue if user selects a file, otherwise EFalse
williamr@2:          * @since 3.1
williamr@2:          */
williamr@2:         IMPORT_C static TBool RunSelectDlgLD(
williamr@2:             TDes& aFileName,
williamr@2:             const TDesC& aStartFolder,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             TInt aFileSelectionResourceId,
williamr@2:             const TDesC& aFileSelectionTitle,
williamr@2:             MAknFileFilter* aFilter = NULL,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2: 
williamr@2:         /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches save dialog.
williamr@2:          * @param aDefaultFileName Full path + the filename that user enters
williamr@2:          *        is stored to this descriptor. The descriptor may contain text
williamr@2:          *        that is used as default filename, for example "Attachment".
williamr@2:          * @param aStartFolder User defined folder to start browsing in file selection.
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection dialog.
williamr@2:          * @param aFileSelectionResourceId A resource id for file selection dialog.
williamr@2:          * @param aFileSelectionTitle Custom title for file selection dialog.
williamr@2:          * @param aFilter Filter asked if a directory entry can be shown in list.
williamr@2:          * @param aObserver An observer which is asked, if set, to verify the
williamr@2:          *        filename that user types.
williamr@2:          * @return Returns ETrue if user accepts or enters a filename, otherwise
williamr@2:          *         EFalse.
williamr@2:          * @since 3.1
williamr@2:          */
williamr@2:         IMPORT_C static TBool RunSaveDlgLD(
williamr@2:             TDes& aDefaultFileName,
williamr@2:             const TDesC& aStartFolder,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             TInt aFileSelectionResourceId,
williamr@2:             const TDesC& aFileSelectionTitle,
williamr@2:             MAknFileFilter* aFilter = NULL,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2: 
williamr@2:         /**
williamr@2:          * DEPRECATED: Use AknCommonDialogsDynMem funcions instead.
williamr@2:          *
williamr@2:          * A static method that launches folder selection dialog.
williamr@2:          * @param aFolder Full path of the folder that user selects is stored to this
williamr@2:          *        descriptor.
williamr@2:          * @param aStartFolder User defined folder to start browsing in file selection.
williamr@2:          * @param aMemorySelectionResourceId A resource id for memory selection dialog.
williamr@2:          * @param aFileSelectionResourceId A resource id for file selection dialog.
williamr@2:          * @param aFileSelectionTitle Custom title for file selection dialog.
williamr@2:          * @param aFilter Filter is asked if a directory entry can be shown in list.
williamr@2:          * @param aObserver An observer which is asked to verify user's selection.
williamr@2:          * @return Returns ETrue if user selects a folder, otherwise EFalse
williamr@2:          * @since 3.1
williamr@2:          */
williamr@2:         IMPORT_C static TBool RunFolderSelectDlgLD(
williamr@2:             TDes& aFolder,
williamr@2:             const TDesC& aStartFolder,
williamr@2:             TInt aMemorySelectionResourceId,
williamr@2:             TInt aFileSelectionResourceId,
williamr@2:             const TDesC& aFileSelectionTitle,
williamr@2:             MAknFileFilter* aFilter = NULL,
williamr@2:             MAknFileSelectionObserver* aObserver = NULL );
williamr@2: 
williamr@2:     };
williamr@2: 
williamr@2: #endif // AKNCOMMONDIALOGS_H
williamr@2: 
williamr@2: // End of File