S60 3rd Edition API Reference: caknfilenamepromptdialog.h Source File

00001 /*
00002 * ==============================================================================
00003 *  Name        : CAknFileNamePromptDialog.h
00004 *  Part of     : Common File Dialogs / CommonDialogs.dll
00005 *  Interface   : ?Interface_category, ?Interface_name
00006 *  Description : ?Description
00007 *  Version     : ?Version
00008 *
00009 *  Copyright (c) 2002-2006 Nokia Corporation.
00010 *  This material, including documentation and any related 
00011 *  computer programs, is protected by copyright controlled by 
00012 *  Nokia Corporation. All rights are reserved. Copying, 
00013 *  including reproducing, storing, adapting or translating, any 
00014 *  or all of this material requires the prior written consent of 
00015 *  Nokia Corporation. This material also contains confidential 
00016 *  information which may not be disclosed to others without the 
00017 *  prior written consent of Nokia Corporation.
00018 * ==============================================================================
00019 */
00020 
00021 #ifndef CAKNFILENAMEPROMPTDIALOG_H
00022 #define CAKNFILENAMEPROMPTDIALOG_H
00023 
00024 // INCLUDES
00025 #include <CAknCommonDialogsBase.h>
00026 
00027 // FORWARD DECLARATIONS
00028 class MAknFileSelectionObserver;
00029 
00030 //  CLASS DEFINITION
00037 NONSHARABLE_CLASS(CAknFileNamePromptDialog) : public CAknCommonDialogsBase
00038         {
00039         public:         // Constructors and destructors
00040 
00046                 IMPORT_C static CAknFileNamePromptDialog* NewL();
00047 
00053                 IMPORT_C static CAknFileNamePromptDialog* NewL( TInt aResourceId );
00054 
00055                 IMPORT_C ~CAknFileNamePromptDialog();
00056 
00057         public:         // New functions
00058 
00063                 IMPORT_C void SetPathL( const TDesC& aPath );
00064 
00069                 IMPORT_C void SetObserver( MAknFileSelectionObserver* aObserver );
00070 
00075                 IMPORT_C void SetTitleL( const TDesC& aText );
00076 
00081                 IMPORT_C void SetLeftSoftkeyL( const TDesC& aText );
00082 
00087                 IMPORT_C void SetRightSoftkeyL( const TDesC& aText );
00088 
00096                 IMPORT_C TBool ExecuteL( TDes& aFileName );
00097 
00102                 IMPORT_C static TBool RunDlgLD( TDes& aFileName,
00103                         const TDesC& aPath,
00104                         MAknFileSelectionObserver* aObserver = NULL );
00105 
00110                 IMPORT_C static TBool RunDlgLD( TDes& aFileName,
00111                         const TDesC& aPath,
00112                         const TDesC& aTitle,
00113                         MAknFileSelectionObserver* aObserver = NULL );
00114 
00119                 IMPORT_C static TBool RunDlgLD( TDes& aFileName,
00120                         const TDesC& aPath,
00121                         TInt aResourceId,
00122                         MAknFileSelectionObserver* aObserver = NULL );
00123 
00124         private:        // New functions
00125 
00134                 static TBool RunL(
00135                         TInt aResourceId,
00136                         TDes& aFileName,
00137                         const TDesC& aPath,
00138                         const TDesC& aTitle,
00139                         MAknFileSelectionObserver* aObserver );
00140 
00144                 void SetResourceId( TInt& aResourceId ) const;
00145 
00149                 void ReadFromResourceL( TInt aResourceId );
00150 
00151         private:        // Constructors and destructors
00152 
00157                 void ConstructFromResourceL( TInt aResourceId );
00158 
00159                 CAknFileNamePromptDialog();
00160 
00161         protected:      // Data
00162 
00163                 // Ref: observer
00164                 MAknFileSelectionObserver* iObserver;
00165 
00166                 // Own: Descriptor for default filename
00167                 HBufC* iDefaultFileName;
00168 
00169                 // Own: Descriptor for path
00170                 HBufC* iPath;
00171                 
00172                 // Own: Descriptor for window title
00173                 HBufC* iTitle;
00174                 
00175                 // Own: Descriptor for left softkey
00176                 HBufC* iLeftSoftkey;
00177                 
00178                 // Own: Descriptor for right softkey
00179                 HBufC* iRightSoftkey;
00180         };
00181 
00182 // CAKNFILENAMEPROMPTDIALOG_H
00183 #endif
00184 
00185 // End of File