/*

* Copyright (c) 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:  A visualizer for data items with separator.

*

*/

#ifndef C_FSSEPARATORVISUALIZER_H

#define C_FSSEPARATORVISUALIZER_H

#include <e32base.h>

//#include <fsconfig.h> <cmail>

// <cmail> SF

#include <alf/alfeventhandler.h>

#include <alf/alflinevisual.h>

// </cmail>

#include "fstreeitemvisualizerbase.h"

class CAlfViewportLayout;

class CFsSeparatorData;

const TInt KDefaultSeparatorThickness = 1;

const TInt KDefaultWidth = 200;

const TInt KDefaultHeight = 5;

/**

 * CFsSeparatorVisualizer is a visualizer for data items separator.

 *

 * Thic class is a concrete implementation for the MFsTreeItemVisualizer 

 * interface. It provides visualization for data items separator.

 * 

 * @code

 *

 * @endcode

 *

 * @lib 

 */

NONSHARABLE_CLASS( CFsSeparatorVisualizer ): 

                                  public CFsTreeItemVisualizerBase

    {

public:

    /**

     * Two-phased constructor

     * 

     * @param aOwnerControl Owner control.

     */

    IMPORT_C static CFsSeparatorVisualizer* NewL( 

                                                 CAlfControl& aOwnerControl );

    /** 

    * C++ destructor

    */

    virtual ~CFsSeparatorVisualizer();    

public: 

    /**

     * The function sets separator's thickness in pixels.

     * 

     * @param aPixelThickness Thickness of the separator line (in pixels)

     */

    virtual void SetSeparatorThickness( const TInt aThickness );

    /**

     * The function returns thikness of the separator line.

     * 

     * @return Thickness of the separator line (in pixels)

     */

    virtual TInt SeparatorThickness( ) const;

    /**

     * Sets the width of separator line. The separator line is always centered 

     * horizontaly. The line width is given as the percentage of the whole item's width.

     * 

     * @param aWidth Percent of item's width covered by separator line. 

     *               Valid values are in range <1.0 , 0.1>    

     */

    virtual void SetSeparatorWidth ( TReal32 aWidth );

    /**

     * Returns the width of the separator line.

     * 

     * @return Percent of item's width covered by separator line.

     */

    virtual TReal32 SetSeparatorWidth ( ) const;

// from base class MFsTreeItemVisualizer

    /**

     * From MFsTreeItemVisualizer.

     * Returns the type of the separator visualizer class.

     */

    virtual TFsTreeItemVisualizerType Type() const;

    /**

     * Sets multiple flags for an item at one time.

     * Setting KFsTreeListItemFocusable flag has o effect - item is always non-focusable.

     * KFsTreeListItemManagedLayout flag has no effect.

     * KFsTreeListItemExtendable flag has no effect.

     * KFsTreeListItemExtended flag has no effect.

     * KFsTreeListItemAlwaysExtended  flag has no effect.

     * 

     * @param aFlags Flags for separator visualizer.

     */

    virtual void SetFlags( TUint32 aFlags );

    /**

     * Returns the size of an item in a normal (not expanded) state.

     * 

     * @return Size in pixels of an item when it is not expanded.

     */

    virtual TSize Size() const;   

    /**

     * From MFsTreeItemVisualizer.

     * Sets the item's visualization state to extended. 

     * Separator cannot be extended - the function has no effect. 

     * 

     * @param aFlag ETrue to visualize item as extended.

     */

    virtual void SetExtended( TBool aFlag );

    /**

     * From MFsTreeItemVisualizer.

     * Returns extended/not extended state of the item visualization.

     * Separator cannot be extended - the function always returns EFalse.

     * 

     * @return EFalse

     */

    virtual TBool IsExtended() const;

    /**

     * From MFsTreeItemVisualizer.

     * Sets if an item can be in expanded state or not.

     * Separator is not expandable - the function has no effect.

     * 

     * @param aFlag ETrue if item can be in expanded state.

     */

    virtual void SetExtendable( TBool aFlag );

    /**

     * From MFsTreeItemVisualizer.

     * Returns an information if item can be in expanded state.

     * Separator is not expandable - the function always returns EFalse.

     * 

     * @return EFalse

     */

    virtual TBool IsExtendable( );

    /**

     * From MFsTreeItemVisualizer.

     * This functions sets wether an item should always be in extended state.

     * 

     * @param ETrue if item should always be in extended state.

     */

    virtual void SetAlwaysExtended( TBool aAlwaysExtended );

    /**

     * From MFsTreeItemVisualizer.

     * This function returns wether an item is always in extended state.

     * 

     * @return ETrue if item is always in extended state.

     */

    virtual TBool IsAlwaysExtended( ) const;

    /**

     * From MFsTreeItemVisualizer.

     * A call to this function means that the item is requested to draw itself

     * within specified parent layout. Data to be visualized is passed as an

     * argument. 

     * 

     * Parameter descriptions will be added when the final function prototype

     * is ready.

     */

    virtual void ShowL( CAlfLayout& aParentLayout,

                        const TUint aTimeout = 0 );

    /**

    * A call to this function means that the item is requested to update its

    * visual content.

    */

    virtual void UpdateL( const MFsTreeItemData& aData,

                          TBool aFocused,

                          const TUint aLevel,

                          CAlfTexture*& aMarkIcon,

                          CAlfTexture*& aMenuIcon,

                          const TUint aTimeout = 0,

                          TBool aUpdateData = ETrue);

    /**

     * From MFsTreeItemVisualizer.

     * A call to this function means that the item goes out of the visible 

     * items scope. The visualizer should destroy all its visuals to save 

     * memory.

     */

    virtual void Hide( const TInt aTimeout = 0 );

    /**

     * From MFsTreeItemVisualizer.

     * This method marquees the text in tree item if it is too long.

     * 

     * @param aMarqueeType Type of marquee.

     * @param aMarqueeSpeed Speed of marquee in pixels per second.

     * @param aMarqueeStartDelay Marquee's start delay in miliseconds.

     * @param aMarqueeCycleStartDelay Marquee cycle's start delay.

     * @param aMarqueeRepetitions Number of marquee's cycles.

     */

    virtual void MarqueeL(const TFsTextMarqueeType aMarqueeType,

                          const TUint aMarqueeSpeed,

                          const TInt aMarqueeStartDelay,

                          const TInt aMarqueeCycleStartDelay,

                          const TInt aMarqueeRepetitions);

protected:

    /**

     * C++ constructor

     * 

     * @param aOwnerControl Owner control.

     */

    CFsSeparatorVisualizer( CAlfControl& aOwnerControl );

    /**

     * Second phase constructor

     *

     */

    void ConstructL( );

protected:

    /**

     * Visual for drawing a separator line.

     */

    CAlfLineVisual* iLineVisual;

    /**

     * Thickness of the separator line (in pixels).

     */

    TInt iThickness;

    /**

     * Width of a separator line - percentage of item's width covered by a separator line.  

     */

    TReal32 iWidth;

    };

#endif  // C_FSSEPARATORVISUALIZER_H