/*

* Copyright (c) 2002-2009 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: 

*

*/

#ifndef CONTENTLISTINGFACTORY_H

#define CONTENTLISTINGFACTORY_H

//  INCLUDES

#include <e32def.h>

// FORWARD DECLARATIONS

class MCLFContentListingEngine;

class MCLFModifiableItem;

class MCLFSortingStyle;

class TResourceReader;

// CLASS DECLARATION

/**

*  Factory for Content Listing Framework.

*  You can create new instances of Content Listing Engines, Modifiable items

*  and Sorting Styles by using this factory.<br><br>

*  Example:

*  @code

*  // Create a new instance of Content Listing Engine

*  MCLFContentListingEngine* engine =

*      ContentListingFactory::NewContentListingEngineLC();

*

*  // Create a new instance of Sorting style

*  MCLFSortingStyle* sortingStyle =

*      ContentListingFactory::NewSortingStyleLC();

*

*  // Create a new instance of Modifiable item

*  MCLFModifiableItem* modItem =

*      ContentListingFactory::NewModifiableItemLC();

*  @endcode

*

*  @lib ContentListingFramework.lib

*  @since S60 3.1

*/

class ContentListingFactory

    {

    public: // New functions

        /**

        * Create new instance of Content Listing Engine.

        * @since S60 3.1

        * @return New instance of Content Listing Engine.

        *         Ownership is transferred to the client application.

        */

        IMPORT_C static MCLFContentListingEngine* NewContentListingEngineLC();

        /**

        * Create new instance of Modifiable Item.

        * @since S60 3.1

        * @return New instance of Modifiable Item.

        *         Ownership is transferred to the client application.

        */

        IMPORT_C static MCLFModifiableItem* NewModifiableItemLC();

        /**

        * Create new instance of Sorting Style.

        * @since S60 3.1

        * @return New instance of the Sorting Style.

        *         Ownership is transferred to the client application.

        */

        IMPORT_C static MCLFSortingStyle* NewSortingStyleLC();

        /**

        * Create new instance of Sorting Style from resource of the

        * application by using TResourceReader.

        * @since S60 3.1

        * @param aResource Resource reader to sorting style resource.

        *                  Use resource struct CLF_SORTING_STYLE. See

        *                  CLFContentListing.rh

        * @return New instance of the Sorting Style.

        *         Ownership is transferred to the client application.

        */

        IMPORT_C static MCLFSortingStyle* NewSortingStyleLC(

                                                TResourceReader& aResource );

    private:

        // Prohibit C++ default constructor.

        ContentListingFactory();

        // Prohibit Destructor.

        ~ContentListingFactory();

    };

#endif      // CONTENTLISTINGFACTORY_H

// End of File