/*
* 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