classicui_plat/common_file_dialogs_api/inc/CAknMemorySelectionSettingPage.h
changeset 46 0e1e0022bd03
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/classicui_plat/common_file_dialogs_api/inc/CAknMemorySelectionSettingPage.h	Thu Jul 29 14:21:56 2010 +0800
@@ -0,0 +1,137 @@
+/*
+* Copyright (c) 2002-2007 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:  Setting page used to selection target memory.
+*
+*/
+
+
+
+#ifndef C_AKNMEMORYSELECTIONSETTINGPAGE_H
+#define C_AKNMEMORYSELECTIONSETTINGPAGE_H
+
+
+#include <CAknMemorySelectionDialog.h>
+
+class MAknMemorySelectionObserver;
+
+/**
+ *  A class that launches a popup setting page for memory selection.
+ *
+ *  @lib CommonDialogs.lib
+ *  @since S60 1.2
+ */
+NONSHARABLE_CLASS(CAknMemorySelectionSettingPage)
+    : public CAknMemorySelectionDialog
+    {
+
+public:
+
+// Constructors and destructors
+
+    /**
+     * Static constructor. Loads default settings.
+     * @return Returns a pointer to an instance of itself.
+     */
+    IMPORT_C static CAknMemorySelectionSettingPage* NewL();
+
+    /**
+     * Static constructor.
+     * @param aResourceId A resource id (MEMORYSELECTIONDIALOG).
+     * @return Returns a pointer to an instance of itself.
+     */
+    IMPORT_C static CAknMemorySelectionSettingPage* NewL( TInt aResourceId );
+
+    IMPORT_C ~CAknMemorySelectionSettingPage();
+
+// New functions
+
+    /**
+     * Executes the memory selection setting page.
+     *
+     * @param aSelectedMemory A reference to a memory (TMemory).
+     *        If one of the memories is selected, the selected memory is
+     *        stored to the parameter.
+     * @return Returns true if user has selected an item and false
+     *         if user hits cancel.
+     */
+    IMPORT_C TReturnKey ExecuteL( TMemory& aSelectedMemory );
+
+
+    /**
+     * Executes the memory selection setting page.
+     *
+     * @param aSelectedMemory A reference to a memory (TMemory).
+     *        If one of the memories is selected, the selected memory is
+     *        stored to the parameter.
+     * @param aRootPath A pointer to a descriptor where the root path
+     *        of the selected memory is stored.
+     * @param aDefaultFolder A pointer to a descriptor where the default folder
+     *        of the selected memory is stored.
+     * @return Returns true if user has selected an item and false
+     *         if user hits cancel.
+     */
+    IMPORT_C TReturnKey ExecuteL(
+        TMemory& aSelectedMemory, TDes* aRootPath, TDes* aDefaultFolder );
+
+    /**
+     * Static methods for launching memory selection dialog
+     * Parameters & return value are descibed in method RunL
+     */
+
+    IMPORT_C static TBool RunDlgLD( TMemory& aSelectedMemory,
+        MAknMemorySelectionObserver* aObserver = NULL );
+
+    IMPORT_C static TBool RunDlgLD( TMemory& aSelectedMemory,
+        const TDesC& aTitle,
+        MAknMemorySelectionObserver* aObserver = NULL );
+
+    IMPORT_C static TBool RunDlgLD( TMemory& aSelectedMemory,
+        TInt aResourceId,
+        TDes* aRootPath = NULL, TDes* aDefaultFolder = NULL,
+        MAknMemorySelectionObserver* aObserver = NULL );
+
+private:    
+
+// Constructors and destructors
+
+    CAknMemorySelectionSettingPage();
+
+// New functions
+
+    /**
+     * A static method for launching a memory selection setting page.
+     * Creates, constructs, runs and deletes a memory selection dialog with
+     * different parameters.
+     *
+     * @param aResourceId An id of a resource.
+     * @param aSelectedMemory A reference to a memory described in ExecuteL.
+     * @param aTitle A title for memory selection dialog.
+     * @param aRootPath A pointer to a descriptor where the root path
+     *        of the selected memory is stored.
+     * @param aDefaultFolder A pointer to a descriptor where the default folder
+     *        of the selected memory is stored.
+     * @param aObserver An observer which is asked if the selected item
+     *        can be selected. Implemented in application.
+     */
+    static TBool RunL(
+        TInt aResourceId,
+        TMemory& aSelectedMemory,
+        const TDesC& aTitle,
+        TDes* aRootPath,
+        TDes* aDefaultFolder,
+        MAknMemorySelectionObserver* aObserver );
+
+    };
+
+#endif // C_AKNMEMORYSELECTIONSETTINGPAGE_H