/*
* Copyright (c) 2006 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:  Media Fetch implementation plug-in loader
*
*/


#ifndef MEDIAFETCH_H
#define MEDIAFETCH_H

#include <e32base.h>
#include <badesca.h>
#include <MediaFileTypes.hrh>

class MMGFetchVerifier;
class MMGFetchCanceler;
class CMediaFetchImplementation;
class MDesCArray;

/**
 *  Media Fetch ECom plug-in loader
 *
 *  Loads the ECom plug-in with the highest version number that supports the
 *  media type(s) given at construction parameter.
 *
 *  @lib MGFetch.lib
 *  @since S60 v3.2
 */
NONSHARABLE_CLASS( CMediaFetch ) : public CBase
    {

public:

    static CMediaFetch* NewL( TInt aMediaType );

    static CMediaFetch* NewLC( TInt aMediaType );

    virtual ~CMediaFetch();

    /**
     *
     * @since S60 v3.2
     * @param aMultiSelect if ETrue then multiselection fetcher is enabled
     */
    void SetMultiSelectionL( TBool aMultiSelect );

    /**
     *
     * @since S60 v3.2
     * @param aMimeTypes plug-in should show only files with given Mime types
     */
    void SetMimeTypesL( const MDesCArray& aMimeTypes );

    /**
     *
     * @since S60 v3.2
     * @param aSelectionSoftkey Custom selection softkey label
     */
    void SetSelectionSoftkeyL( const TDesC& aSelectionSoftkey );

    /**
     *
     * @since S60 v3.2
     * @param aHeading Custom heading text for fetcher
     */
    void SetHeadingL( const TDesC& aHeading );

    /**
     *
     * @since S60 v3.2
     * @param aVerifier See MMGFetchVerifier.h
     */
    void SetVerifierL( MMGFetchVerifier& aVerifier );

    /**
     *
     * @since S60 v3.2
     * @param aCanceler See MMGFetchCanceler.h
     */
    void GetCancelerL( MMGFetchCanceler*& aCanceler );

    /**
     *
     *
     * @since S60 v3.2
     * @param aSelectedFiles array to hold selected items
     * @param aMediaType type of fetcher to use
     * @return ETrue if user selected files, EFalse if user canceled the fetcher
     */
    TBool LaunchL( CDesCArray& aSelectedFiles,
                   TMediaFileType aMediaType );

private:

    inline CMediaFetch();

    inline void ConstructL( TInt aMediaType );

private: // data

    /**
     * Fetcher implementation
     * Own.
     */
    CMediaFetchImplementation* iFetcher;

    };

#endif // MEDIAFETCH_H