AknCommonDialogsDynMem Class Reference

API published in: S60 3rd Ed FP 2

Link against: commondialogs.lib

Capability Information

Required Capabilities

None

#include <akncommondialogsdynmem.h>

Detailed Description

New version of AknCommonDialogs class suporting dynamic drives such as remote drive.

Use this instead of now deprecated old AknCommonDialogs.

A simple facade class that consists of static functions that launch UI components in a sequence. First, memory selection component is launched and then file/directory selection component. In save and move dialogs directory selection may not be shown if there are no subdirectories to choose from. In save dialog, finally filename prompt component is launched.

All methods have an obligatory resource ID parameter for memory selection because it contains the paths for both memories (Phone&MMC) (LOCATION structs). New TMemoryTypes functionality allows defining dynamic memories to be used.

If set, an observer is queried just before exiting the dialog. At this point the application can either reject or accept user's selection. Every dialog returns a boolean value which tells if user has selected something or not.


Public Types
enum   TMemoryTypes {
  EMemoryTypePhone = 0x00000001, EMemoryTypeMMC = 0x00000002, EMemoryTypeRemote = 0x00000004, EMemoryTypeInternalMassStorage = 0x00000008,
  EMemoryTypeMMCExternal = 0x00000010
}
  Bit flag definition of the memory types that will be listed by the dialog. More...

Static Public Member Functions
static IMPORT_C TBool  RunSelectDlgLD (TInt aIncludedMedias, TDes &aFileName, TInt aMemorySelectionResourceId, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches file selection dialog.
static IMPORT_C TBool  RunSelectDlgLD (TInt aIncludedMedias, TDes &aFileName, TInt aMemorySelectionResourceId, MAknFileFilter *aFilter, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches file selection dialog.
static IMPORT_C TBool  RunSelectDlgLD (TInt aIncludedMedias, TDes &aFileName, TInt aMemorySelectionResourceId, const TDesC &aFileSelectionTitle, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches file selection dialog.
static IMPORT_C TBool  RunSelectDlgLD (TInt aIncludedMedias, TDes &aFileName, TInt aMemorySelectionResourceId, TInt aFileSelectionResourceId, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches file selection dialog.
static IMPORT_C TBool  RunMoveDlgLD (TInt aIncludedMedias, TDes &aDirectory, TInt aMemorySelectionResourceId, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches move dialog.
static IMPORT_C TBool  RunMoveDlgLD (TInt aIncludedMedias, TDes &aDirectory, TInt aMemorySelectionResourceId, MAknFileFilter *aFilter, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches move dialog.
static IMPORT_C TBool  RunMoveDlgLD (TInt aIncludedMedias, TDes &aDirectory, TInt aMemorySelectionResourceId, const TDesC &aFileSelectionTitle, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches move dialog.
static IMPORT_C TBool  RunMoveDlgLD (TInt aIncludedMedias, TDes &aDirectory, TInt aMemorySelectionResourceId, TInt aFileSelectionResourceId, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches move dialog.
static IMPORT_C TBool  RunSaveDlgLD (TInt aIncludedMedias, TDes &aDefaultFileName, TInt aMemorySelectionResourceId, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches save dialog which does not run folder selection dialog at all.
static IMPORT_C TBool  RunSaveDlgLD (TInt aIncludedMedias, TDes &aDefaultFileName, TInt aMemorySelectionResourceId, MAknFileFilter *aFilter, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches save dialog.
static IMPORT_C TBool  RunSaveDlgLD (TInt aIncludedMedias, TDes &aDefaultFileName, TInt aMemorySelectionResourceId, const TDesC &aFileSelectionTitle, const TDesC &aFileNamePromptTitle, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches save dialog.
static IMPORT_C TBool  RunSaveDlgLD (TInt aIncludedMedias, TDes &aDefaultFileName, TInt aMemorySelectionResourceId, TInt aFileSelectionResourceId, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches save dialog.
static IMPORT_C TBool  RunSaveDlgLD (TInt aIncludedMedias, TDes &aDefaultFileName, TInt aMemorySelectionResourceId, TInt aFileSelectionResourceId, const TDesC &aFileNamePromptTitle, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches save dialog.
static IMPORT_C TBool  RunSaveDlgNoDirectorySelectionLD (TInt aIncludedMedias, TDes &aDefaultFileName, TInt aMemorySelectionResourceId, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches save dialog.
static IMPORT_C TBool  RunSaveDlgNoDirectorySelectionLD (TInt aIncludedMedias, TDes &aDefaultFileName, TInt aMemorySelectionResourceId, const TDesC &aFileNamePromptTitle, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches save dialog.
static IMPORT_C TBool  RunCopyDlgLD (TInt aIncludedMedias, TDes &aDirectory, TInt aMemorySelectionResourceId, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches copy dialog.
static IMPORT_C TBool  RunCopyDlgLD (TInt aIncludedMedias, TDes &aDirectory, TInt aMemorySelectionResourceId, MAknFileFilter *aFilter, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches copy dialog.
static IMPORT_C TBool  RunCopyDlgLD (TInt aIncludedMedias, TDes &aDirectory, TInt aMemorySelectionResourceId, TInt aFileSelectionResourceId, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches copy dialog.
static IMPORT_C TBool  RunSelectDlgLD (TInt aIncludedMedias, TDes &aFileName, const TDesC &aStartFolder, TInt aMemorySelectionResourceId, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches file selection dialog.
static IMPORT_C TBool  RunSelectDlgLD (TInt aIncludedMedias, TDes &aFileName, const TDesC &aStartFolder, TInt aMemorySelectionResourceId, MAknFileFilter *aFilter, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches file selection dialog.
static IMPORT_C TBool  RunSelectDlgLD (TInt aIncludedMedias, TDes &aFileName, const TDesC &aStartFolder, TInt aMemorySelectionResourceId, const TDesC &aFileSelectionTitle, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches file selection dialog.
static IMPORT_C TBool  RunSelectDlgLD (TInt aIncludedMedias, TDes &aFileName, const TDesC &aStartFolder, TInt aMemorySelectionResourceId, TInt aFileSelectionResourceId, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches file selection dialog.
static IMPORT_C TBool  RunSelectDlgLD (TInt aIncludedMedias, TDes &aFileName, const TDesC &aStartFolder, TInt aMemorySelectionResourceId, TInt aFileSelectionResourceId, const TDesC &aFileSelectionTitle, MAknFileFilter *aFilter=NULL, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches file selection dialog.
static IMPORT_C TBool  RunSaveDlgLD (TInt aIncludedMedias, TDes &aDefaultFileName, const TDesC &aStartFolder, TInt aMemorySelectionResourceId, TInt aFileSelectionResourceId, const TDesC &aFileSelectionTitle, MAknFileFilter *aFilter=NULL, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches save dialog.
static IMPORT_C TBool  RunFolderSelectDlgLD (TInt aIncludedMedias, TDes &aFolder, const TDesC &aStartFolder, TInt aMemorySelectionResourceId, TInt aFileSelectionResourceId, const TDesC &aFileSelectionTitle, MAknFileFilter *aFilter=NULL, MAknFileSelectionObserver *aObserver=NULL)
  A static method that launches folder selection dialog.

Member Enumeration Documentation

enum AknCommonDialogsDynMem::TMemoryTypes
 

Bit flag definition of the memory types that will be listed by the dialog.

These are used in the new functions to include for example remote drives. In case new media types are added in the future, the types can be added to the end of this enumeration.

Application logic and UI specification is mainly interested in division between 'phone memory' and 'MMC' with the latest addition of 'remote drives'. In Symbian OS level this is somewhat more complicated because these do not map directly to any drive or memory type. For example try defining the drive letter for remote drive.

Basically TMediaType could be used but the types may vary in the same drive and application logic mostly understands only division between 'phone' and 'MMC' memory - these do not map to TMediaType directly. This the reasoning for this new enumeration.

Uses binary flagging.

Use for example 'EMemoryTypePhone|EMemoryTypeMMC|EMemoryTypeRemote' to have phone memory, MMC and remote drives included.

Notice: 0 value means no media included. Only EMemoryTypePhone|EMemoryTypeMMC for legacy applications and EMemoryTypePhone|EMemoryTypeMMC|EMemoryTypeRemote for new remote drives-aware applications are supported for the time being. Use EMemoryTypePhone|EMemoryTypeInternalMassStorage|EMemoryMMCExternal |EMemoryTypeRemote for multiple drive support. And EMemoryTypeMMC will be deprecated.

Enumerator:
EMemoryTypePhone  EMemoryTypePhone Device memory drive inside phone.

There might be multiple device memory drives because of multiple partitions.

EMemoryTypeMMC  It will be mapped to EMemoryTypeInternalMassStorage|EMemoryMMCExternal internally.

EMemoryTypeMMC Standard external removable memory card drive

There might be multiple removable MMC drives because of multiple partitions.

EMemoryTypeRemote  EMemoryTypeRemote Remote drive.

There might be multiple remote drives.

EMemoryTypeInternalMassStorage  EMemoryTypeInternalMassStorage Internal mass storage, like internal MMC, hard disk, flash, etc.

There might be multiple internal disk drives

EMemoryTypeMMCExternal  EMemoryTypeMMCExternal Removable external memory card.

Member Function Documentation

static IMPORT_C TBool AknCommonDialogsDynMem::RunCopyDlgLD (  TInt  aIncludedMedias,
TDes &  aDirectory,
TInt  aMemorySelectionResourceId,
TInt  aFileSelectionResourceId,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches copy dialog.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aDirectory  Full path of the folder that user selects is stored to this descriptor.
aMemorySelectionResourceId  A resource id for memory selection dialog
aFileSelectionResourceId  A resource id for file selection dialog
aObserver  An observer which is asked, if set, to verify user's selection.
Returns:
Returns ETrue if user selects a folder, otherwise EFalse
static IMPORT_C TBool AknCommonDialogsDynMem::RunCopyDlgLD (  TInt  aIncludedMedias,
TDes &  aDirectory,
TInt  aMemorySelectionResourceId,
MAknFileFilter *  aFilter,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches copy dialog.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aDirectory  Full path of the folder that user selects is stored to this descriptor.
aMemorySelectionResourceId  A resource id for memory selection dialog.
aFilter  Filter is asked if a directory entry can be shown in list. Ownership is not transferred.
aObserver  An observer which is asked, if set, to verify user's selection.
Returns:
Returns ETrue if user selects a folder, otherwise EFalse.
static IMPORT_C TBool AknCommonDialogsDynMem::RunCopyDlgLD (  TInt  aIncludedMedias,
TDes &  aDirectory,
TInt  aMemorySelectionResourceId,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches copy dialog.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aDirectory  Full path of the folder that user selects is stored to this descriptor.
aMemorySelectionResourceId  A resource id for memory selection dialog.
aObserver  An observer which is asked, if set, to verify user's selection.
Returns:
Returns ETrue if user selects a folder, otherwise EFalse.
static IMPORT_C TBool AknCommonDialogsDynMem::RunFolderSelectDlgLD (  TInt  aIncludedMedias,
TDes &  aFolder,
const TDesC &  aStartFolder,
TInt  aMemorySelectionResourceId,
TInt  aFileSelectionResourceId,
const TDesC &  aFileSelectionTitle,
MAknFileFilter *  aFilter = NULL,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches folder selection dialog.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aFolder  Full path of the folder that user selects is stored to this descriptor.
aStartFolder  User defined folder to start browsing in file selection.
aMemorySelectionResourceId  A resource id for memory selection dialog.
aFileSelectionResourceId  A resource id for file selection dialog.
aFileSelectionTitle  Custom title for file selection dialog.
aFilter  Filter is asked if a directory entry can be shown in list.
aObserver  An observer which is asked to verify user's selection.
Returns:
Returns ETrue if user selects a folder, otherwise EFalse
static IMPORT_C TBool AknCommonDialogsDynMem::RunMoveDlgLD (  TInt  aIncludedMedias,
TDes &  aDirectory,
TInt  aMemorySelectionResourceId,
TInt  aFileSelectionResourceId,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches move dialog.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aDirectory  Full path of the folder that user selects is stored to this descriptor.
aMemorySelectionResourceId  A resource id for memory selection dialog
aFileSelectionResourceId  A resource id for file selection dialog
aObserver  An observer which is asked, if set, to verify user's selection.
Returns:
Returns ETrue if user selects a folder, otherwise EFalse
static IMPORT_C TBool AknCommonDialogsDynMem::RunMoveDlgLD (  TInt  aIncludedMedias,
TDes &  aDirectory,
TInt  aMemorySelectionResourceId,
const TDesC &  aFileSelectionTitle,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches move dialog.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aDirectory  Full path of the folder that user selects is stored to this descriptor.
aMemorySelectionResourceId  A resource id for memory selection dialog.
aFileSelectionTitle  A custom title for directory selection dialog.
aObserver  An observer which is asked, if set, to verify user's selection.
Returns:
Returns ETrue if user selects a folder, otherwise EFalse
static IMPORT_C TBool AknCommonDialogsDynMem::RunMoveDlgLD (  TInt  aIncludedMedias,
TDes &  aDirectory,
TInt  aMemorySelectionResourceId,
MAknFileFilter *  aFilter,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches move dialog.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aDirectory  Full path of the folder that user selects is stored to this descriptor.
aMemorySelectionResourceId  A resource id for memory selection dialog.
aFilter  Filter is asked if a directory entry can be shown in list. Ownership is not transferred.
aObserver  An observer which is asked, if set, to verify user's selection.
Returns:
Returns ETrue if user selects a folder, otherwise EFalse.
static IMPORT_C TBool AknCommonDialogsDynMem::RunMoveDlgLD (  TInt  aIncludedMedias,
TDes &  aDirectory,
TInt  aMemorySelectionResourceId,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches move dialog.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aDirectory  Full path of the folder that user selects is stored to this descriptor.
aMemorySelectionResourceId  A resource id for memory selection dialog.
aObserver  An observer which is asked, if set, to verify user's selection.
Returns:
Returns ETrue if user selects a folder, otherwise EFalse.
static IMPORT_C TBool AknCommonDialogsDynMem::RunSaveDlgLD (  TInt  aIncludedMedias,
TDes &  aDefaultFileName,
const TDesC &  aStartFolder,
TInt  aMemorySelectionResourceId,
TInt  aFileSelectionResourceId,
const TDesC &  aFileSelectionTitle,
MAknFileFilter *  aFilter = NULL,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches save dialog.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aDefaultFileName  Full path + the filename that user enters is stored to this descriptor. The descriptor may contain text that is used as default filename, for example "Attachment".
aStartFolder  User defined folder to start browsing in file selection.
aMemorySelectionResourceId  A resource id for memory selection dialog.
aFileSelectionResourceId  A resource id for file selection dialog.
aFileSelectionTitle  Custom title for file selection dialog.
aFilter  Filter asked if a directory entry can be shown in list.
aObserver  An observer which is asked, if set, to verify the filename that user types.
Returns:
Returns ETrue if user accepts or enters a filename, otherwise EFalse.
static IMPORT_C TBool AknCommonDialogsDynMem::RunSaveDlgLD (  TInt  aIncludedMedias,
TDes &  aDefaultFileName,
TInt  aMemorySelectionResourceId,
TInt  aFileSelectionResourceId,
const TDesC &  aFileNamePromptTitle,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches save dialog.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aDefaultFileName  Full path + the filename that user enters is stored to this descriptor. The descriptor may contain text that is used as default filename, for example "Attachment".
aMemorySelectionResourceId  A resource id for memory selection dialog.
aFileSelectionResourceId  A resource id for file selection dialog.
aFileNamePromptTitle  Custom title for filename prompt dialog.
aObserver  An observer which is asked, if set, to verify the filename that user types.
Returns:
Returns ETrue if user accepts or enters a filename, otherwise EFalse.
static IMPORT_C TBool AknCommonDialogsDynMem::RunSaveDlgLD (  TInt  aIncludedMedias,
TDes &  aDefaultFileName,
TInt  aMemorySelectionResourceId,
TInt  aFileSelectionResourceId,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches save dialog.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aDefaultFileName  Full path + the filename that user enters is stored to this descriptor. The descriptor may contain text that is used as default filename, for example "Attachment".
aMemorySelectionResourceId  A resource id for memory selection dialog.
aFileSelectionResourceId  A resource id for file selection dialog.
aObserver  An observer which is asked, if set, to verify the filename that user types.
Returns:
Returns ETrue if user accepts or enters a filename, otherwise EFalse.
static IMPORT_C TBool AknCommonDialogsDynMem::RunSaveDlgLD (  TInt  aIncludedMedias,
TDes &  aDefaultFileName,
TInt  aMemorySelectionResourceId,
const TDesC &  aFileSelectionTitle,
const TDesC &  aFileNamePromptTitle,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches save dialog.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aDefaultFileName  Full path + the filename that user enters is stored to this descriptor. The descriptor may contain text that is used as default filename, for example "Attachment".
aMemorySelectionResourceId  A resource id for memory selection dialog.
aFileSelectionTitle  Custom title for file selection dialog.
aFileNamePromptTitle  Custom title for filename prompt dialog.
aObserver  An observer which is asked, if set, to verify the filename that user types.
Returns:
Returns ETrue if user accepts or enters a filename, otherwise EFalse.
static IMPORT_C TBool AknCommonDialogsDynMem::RunSaveDlgLD (  TInt  aIncludedMedias,
TDes &  aDefaultFileName,
TInt  aMemorySelectionResourceId,
MAknFileFilter *  aFilter,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches save dialog.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aDefaultFileName  Full path + the filename that user enters is stored to this descriptor. The descriptor may contain text that is used as default filename, for example "Attachment".
aMemorySelectionResourceId  A resource id for memory selection dialog.
aFilter  Filter is asked if a directory entry can be shown in list. Ownership is not transferred.
aObserver  An observer which is asked, if set, to verify the filename that user types.
Returns:
Returns ETrue if user accepts or enters a filename, otherwise EFalse.
static IMPORT_C TBool AknCommonDialogsDynMem::RunSaveDlgLD (  TInt  aIncludedMedias,
TDes &  aDefaultFileName,
TInt  aMemorySelectionResourceId,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches save dialog which does not run folder selection dialog at all.

Instead the resulting path will be constructed from the root and default folder read from resources and from the file name given by the user.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aDefaultFileName  Full path + the filename that user enters is stored to this descriptor. The descriptor may contain text that is used as default filename, for example "Attachment".
aMemorySelectionResourceId  A resource id for memory selection dialog.
aObserver  An observer which is asked, if set, to verify the filename that user types.
Returns:
Returns ETrue if user accepts or enters a filename, otherwise EFalse.
static IMPORT_C TBool AknCommonDialogsDynMem::RunSaveDlgNoDirectorySelectionLD (  TInt  aIncludedMedias,
TDes &  aDefaultFileName,
TInt  aMemorySelectionResourceId,
const TDesC &  aFileNamePromptTitle,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches save dialog.

No file selection dialog for directory selection is displayed.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aDefaultFileName  Full path + the filename that user enters is stored to this descriptor. The descriptor may contain text that is used as default filename, for example "Attachment".
aMemorySelectionResourceId  A resource id for memory selection dialog. The folders in which the file will be saved should be given in this resource.
aFileNamePromptTitle  Custom title for filename prompt dialog.
aObserver  An observer which is asked, if set, to verify the filename that user types.
Returns:
Returns ETrue if user accepts or enters a filename, otherwise EFalse.
static IMPORT_C TBool AknCommonDialogsDynMem::RunSaveDlgNoDirectorySelectionLD (  TInt  aIncludedMedias,
TDes &  aDefaultFileName,
TInt  aMemorySelectionResourceId,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches save dialog.

No file selection dialog for directory selection is displayed.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aDefaultFileName  Full path + the filename that user enters is stored to this descriptor. The descriptor may contain text that is used as default filename, for example "Attachment".
aMemorySelectionResourceId  A resource id for memory selection dialog. The folders in which the file will be saved should be given in this resource.
aObserver  An observer which is asked, if set, to verify the filename that user types.
Returns:
Returns ETrue if user accepts or enters a filename, otherwise EFalse.
static IMPORT_C TBool AknCommonDialogsDynMem::RunSelectDlgLD (  TInt  aIncludedMedias,
TDes &  aFileName,
const TDesC &  aStartFolder,
TInt  aMemorySelectionResourceId,
TInt  aFileSelectionResourceId,
const TDesC &  aFileSelectionTitle,
MAknFileFilter *  aFilter = NULL,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches file selection dialog.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aFileName  Full path and filename of the file that user selects is stored to this descriptor.
aStartFolder  User defined folder to start browsing in file selection.
aMemorySelectionResourceId  A resource id for memory selection dialog.
aFileSelectionResourceId  A resource id for file selection dialog.
aFileSelectionTitle  Custom title for file selection dialog.
aFilter  Filter asked if a directory entry can be shown in list.
aObserver  An observer which is asked to verify user's selection.
Returns:
Returns ETrue if user selects a file, otherwise EFalse
static IMPORT_C TBool AknCommonDialogsDynMem::RunSelectDlgLD (  TInt  aIncludedMedias,
TDes &  aFileName,
const TDesC &  aStartFolder,
TInt  aMemorySelectionResourceId,
TInt  aFileSelectionResourceId,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches file selection dialog.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aFileName  Full path and filename of the file that user selects is stored to this descriptor.
aStartFolder  User defined folder to start browsing in file selection
aMemorySelectionResourceId  A resource id for memory selection dialog.
aFileSelectionResourceId  A resource id for file selection dialog.
aObserver  An observer which is asked, if set, to verify user's selection.
Returns:
Returns ETrue if user selects a file, otherwise EFalse.
static IMPORT_C TBool AknCommonDialogsDynMem::RunSelectDlgLD (  TInt  aIncludedMedias,
TDes &  aFileName,
const TDesC &  aStartFolder,
TInt  aMemorySelectionResourceId,
const TDesC &  aFileSelectionTitle,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches file selection dialog.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aFileName  Full path and filename of the file that user selects is stored to this descriptor.
aStartFolder  User defined folder to start browsing in file selection
aMemorySelectionResourceId  A resource id for memory selection dialog.
aFileSelectionTitle  A custom title for file selection dialog.
aObserver  An observer which is asked, if set, to verify user's selection.
Returns:
Returns ETrue if user selects a file, otherwise EFalse.
static IMPORT_C TBool AknCommonDialogsDynMem::RunSelectDlgLD (  TInt  aIncludedMedias,
TDes &  aFileName,
const TDesC &  aStartFolder,
TInt  aMemorySelectionResourceId,
MAknFileFilter *  aFilter,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches file selection dialog.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aFileName  Full path and filename of the file that user selects is stored to this descriptor.
aStartFolder  User defined folder to start browsing in file selection
aMemorySelectionResourceId  A resource id for memory selection dialog.
aFilter  Filter is asked if a directory entry can be shown in list. Ownership is not transferred.
aObserver  An observer which is asked, if set, to verify user's selection.
Returns:
Returns ETrue if user selects a file, otherwise EFalse.
static IMPORT_C TBool AknCommonDialogsDynMem::RunSelectDlgLD (  TInt  aIncludedMedias,
TDes &  aFileName,
const TDesC &  aStartFolder,
TInt  aMemorySelectionResourceId,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches file selection dialog.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aFileName  Full path and filename of the file that user selects is stored to this descriptor.
aStartFolder  User defined folder to start browsing in file selection.
aMemorySelectionResourceId  A resource id for memory selection dialog.
aObserver  An observer which is asked, if set, to verify user's selection.
Returns:
Returns ETrue if user selects a file, otherwise EFalse.
static IMPORT_C TBool AknCommonDialogsDynMem::RunSelectDlgLD (  TInt  aIncludedMedias,
TDes &  aFileName,
TInt  aMemorySelectionResourceId,
TInt  aFileSelectionResourceId,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches file selection dialog.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aFileName  Full path and filename of the file that user selects is stored to this descriptor.
aMemorySelectionResourceId  A resource id for memory selection dialog.
aFileSelectionResourceId  A resource id for file selection dialog.
aObserver  An observer which is asked, if set, to verify user's selection.
Returns:
Returns ETrue if user selects a file, otherwise EFalse.
static IMPORT_C TBool AknCommonDialogsDynMem::RunSelectDlgLD (  TInt  aIncludedMedias,
TDes &  aFileName,
TInt  aMemorySelectionResourceId,
const TDesC &  aFileSelectionTitle,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches file selection dialog.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aFileName  Full path and filename of the file that user selects is stored to this descriptor.
aMemorySelectionResourceId  A resource id for memory selection dialog.
aFileSelectionTitle  A custom title for file selection dialog.
aObserver  An observer which is asked, if set, to verify user's selection.
Returns:
Returns ETrue if user selects a file, otherwise EFalse.
static IMPORT_C TBool AknCommonDialogsDynMem::RunSelectDlgLD (  TInt  aIncludedMedias,
TDes &  aFileName,
TInt  aMemorySelectionResourceId,
MAknFileFilter *  aFilter,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches file selection dialog.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aFileName  Full path and filename of the file that user selects is stored to this descriptor.
aMemorySelectionResourceId  A resource id for memory selection dialog.
aFilter  Filter is asked if a directory entry can be shown in list. Ownership is not transferred.
aObserver  An observer which is asked, if set, to verify user's selection.
Returns:
Returns ETrue if user selects a file, otherwise EFalse.
static IMPORT_C TBool AknCommonDialogsDynMem::RunSelectDlgLD (  TInt  aIncludedMedias,
TDes &  aFileName,
TInt  aMemorySelectionResourceId,
MAknFileSelectionObserver *  aObserver = NULL
)  [static]
 

A static method that launches file selection dialog.

Parameters:
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes.
aFileName  Full path and filename of the file that user selects is stored to this descriptor.
aIncludedMedias  defines which medias are included in the dialog. See TMemoryTypes
aMemorySelectionResourceId  A resource id for memory selection dialog.
aObserver  An observer which is asked, if set, to verify user's selection.
Returns:
Returns ETrue if user selects a file, otherwise EFalse.
The documentation for this class was generated from the following file:
Copyright © Nokia Corporation 2001-2008
Back to top