/*

* Copyright (c) 2003 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:  ?Description

*

*/

#ifndef CMIDCOMPONENTFACTORY_H

#define CMIDCOMPONENTFACTORY_H

#include <e32def.h>

#include <lcdui.h>

#include <coecntrl.h>

class CMIDUIManager;

class CMIDUtils;

/**

 *

 * Concrete implementation for constructing native peers to LCDUI objects

 *

 */

NONSHARABLE_CLASS(CMIDComponentFactory) : public CBase, public MMIDComponentFactory

{

public:

    CMIDComponentFactory();

    void ConstructL(MMIDEnv& aEnv);

    //

    // Classes derived from Displayable

    //

    MMIDDisplayable* CreateDisplayableL();

    MMIDCanvas* CreateCanvasL(MMIDDisplayable& aDisplayable, MMIDComponent::TType aCanvasType);

    MMIDAlert* CreateAlertL(MMIDDisplayable& aDisplayable,MMIDAlert::TAlertType aType,const TDesC& aString,MMIDImage* aImage);

    MMIDForm* CreateFormL(MMIDDisplayable& aDisplayable);

    MMIDList* CreateListL(TInt aType,MMIDDisplayable& aDisplayable,RArray<TPtrC>& aStringArray, RArray<MMIDImage*>& aImageArray);

    MMIDTextBox* CreateTextBoxL(TInt aConstraints,TInt aMaxSize,const TDesC& aText,MMIDDisplayable& aDisplayable);

    //

    // Classes derived from Item

    //

    MMIDImageItem* CreateImageItemL(const TDesC& aLabel,MMIDImage* aImage,MMIDItem::TLayout aLayout,MMIDItem::TAppearance aAppearance,const TDesC& aAltText);

    MMIDCustomItem* CreateCustomItemL(const TDesC& aLabel);

    MMIDStringItem* CreateStringItemL(const TDesC& aLabel,const TDesC& aText,MMIDItem::TAppearance aAppearance);

    MMIDDateField* CreateDateFieldL(const TDesC& aLabel,MMIDDateField::TFieldType aFieldType);

    MMIDGauge* CreateGaugeL(const TDesC& aLabel,TBool aInteractive,TInt aMaxValue,TInt aInitialValue);

    MMIDTextField* CreateTextFieldL(const TDesC& aLabel,const TDesC& aText,TInt aConstraints,TInt aMaxSize);

    MMIDChoiceGroup* CreateChoiceGroupL(const TDesC& aLabel,TInt aType,RArray<TPtrC>& aStringArray, RArray<MMIDImage*>& aImageArray);

    MMIDSpacer* CreateSpacerL(const TSize& aMinimumSize);

    //

    // Other UI classes

    //

    MMIDFont* CreateFontL(TUint aStyle,TUint aSize,TInt aFace,TBool aIsFreeSizeFont);

    MMIDTicker* CreateTickerL(const TDesC& aText);

    MMIDCommand* CreateCommandL(const TDesC& aShortLabel,const TDesC& aLongLabel,MMIDCommand::TCommandType aCommandType,TInt aPriority,TInt aCommandID);

    //

    // Other methods

    //

    MMIDUtils* CreateUtilsL();

    /**

     * Creates a new text editor component. Note that text editor is current

     * a custom component and not a standard LCDUI UI component.

     *

     * The implementation is part of nokialcdui component and s60lcdui plug-in.

     *

     * The ownership is transferred to the caller.

     *

     * @param aMaxSize The maximum size of the editor's content.

     * @param aWidth The width of the editor in pixels.

     * @param aHeight The height of the editor in pixels.

     * @param aHeightInRows Defines whether the height of the editor should be

     *        represented as in rows or in pixels.

     * @since S60 5.0

     */

    MMIDTextEditor* CreateTextEditorL(

        TInt aMaxSize,

        TInt aWidth,

        TInt aHeight,

        TBool aHeightInRows);

    /**

     * Creates a new canvas graphics item component. Note that canvas

     * graphics item is currently a custom component and not a standard

     * LCDUI UI component.

     *

     * The implementation is part of nokialcdui component and s60lcdui plug-in.

     *

     * The ownership is transferred to the caller.

     *

     * @param aItemPainter Pointer to its painter control.

     * @since S60 5.0

     */

    MMIDCanvasGraphicsItem* CreateCanvasGraphicsItemL(

        MMIDCanvasGraphicsItemPainter* aItemPainter);

    /**

     * Creates a new canvas graphics item painter control.

     *

     * The implementation is part of nokialcdui component and s60lcdui plug-in.

     *

     * The ownership is transferred to the caller.

     *

     * @param aWidth The width of the editor in pixels.

     * @param aHeight The height of the editor in pixels.

     * @since S60 5.0

     */

    MMIDCanvasGraphicsItemPainter* CreateCanvasGraphicsItemPainterL(

        TInt aWidth,

        TInt aHeight);

    void Dispose();

private:

    ~CMIDComponentFactory();

    /**

     * Get iUtils instance. If iUtils is NULL, it creates new one.

     * The ownership is not transferred.

     *

     * @return Shared instance of CMIDUtils.

     * @since S60 5.0

     */

    CMIDUtils* GetUtils();

private:

    MMIDEnv* iEnv;

    CMIDUIManager* iUIManager;

    TBool displayableCreated;

    // Shared instance of CMIDUtils. Other components uses this instance.

    // Those components gets it by GetUtils method. Owned

    CMIDUtils* iUtils;

};

#endif // CMIDCOMPONENTFACTORY_H